API açarının əldə edilməsi
EvilMail API-dən istifadə etmək üçün əvvəlcə API açarı lazımdır. Hesabınıza daxil olun, "Settings" > "API Keys" bölməsinə keçin və "Generate New Key" düyməsini basın. API açarınızı təhlükəsiz yerdə saxlayın — o yalnız bir dəfə göstərilir. Açarı mühit dəyişəni kimi saxlamaq tövsiyə olunur, birbaşa kodda yazmayın.
Əsas endpointlar
EvilMail REST API aşağıdakı əsas endpointları təqdim edir:
GET /v1/inboxes - Bütün poçt qutularını siyahıla
POST /v1/inboxes - Yeni poçt qutusu yarat
GET /v1/inboxes/{id} - Poçt qutusu detallarını al
DELETE /v1/inboxes/{id} - Poçt qutusunu sil
GET /v1/inboxes/{id}/messages - Mesajları siyahıla
GET /v1/messages/{id} - Mesaj detallarını al
POST /v1/messages - Mesaj göndər
GET /v1/domains - Domenləri siyahılacurl nümunələri
Yeni poçt qutusu yaratmaq:
curl -X POST https://api.evilmail.com/v1/inboxes
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"name": "test-inbox", "domain": "example.com"}'Mesajları əldə etmək:
curl https://api.evilmail.com/v1/inboxes/{inbox_id}/messages
-H "Authorization: Bearer YOUR_API_KEY"Mesaj göndərmək:
curl -X POST https://api.evilmail.com/v1/messages
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"from": "[email protected]", "to": "[email protected]", "subject": "Test", "body": "Hello!"}'İstifadə halları
EvilMail API müxtəlif ssenarilərdə istifadə oluna bilər:
- Avtomatlaşdırılmış testlər: CI/CD boru kəmərinizdə e-poçt doğrulama axınlarını sınayın.
- Müvəqqəti e-poçtlar: İstifadəçilər üçün birdəfəlik ünvanlar yaradın.
- E-poçt yönləndirmə: Daxil olan e-poçtları webhook vasitəsilə tətbiqinizə yönləndirin.
- Monitorinq: E-poçt trafikini izləyin və analiz edin.
Xəta idarəetməsi
API standart HTTP status kodları qaytarır: 200 uğurlu əməliyyat, 201 yaradıldı, 400 yanlış sorğu, 401 icazəsiz, 404 tapılmadı, 429 çox sayda sorğu. Rate limit aşıldıqda Retry-After başlığına əsasən gözləyin.
ƏvvəlkiDNS qeydlərinin sirri açıldı: A, MX, CNAME, TXT və digərləriSonrakıThunderbird, Outlook və Apple Mail-i POP3 və IMAP vasitəsilə EvilMail-ə qoşmaq