Bevezetés
Az EvilMail REST API lehetővé teszi, hogy az eldobható e-mail funkciókat közvetlenül az alkalmazásodba integráld. Legyen szó automatizált tesztelésről, felhasználói regisztrációs folyamatokról vagy e-mail alapú munkafolyamatokról — az API mindent lefed.
Hitelesítés
Minden API-kéréshez Bearer token hitelesítés szükséges. Az API-kulcsodat az EvilMail felhasználói felületén, a Beállítások > API menüpontban találod.
curl -X GET https://api.evilmail.com/v1/account
-H "Authorization: Bearer YOUR_API_KEY"Az API-kulcsodat kezeld bizalmasan. Soha ne tárold a forráskódban — használj környezeti változókat vagy titkosított tárhelyet (secret manager).
Fő végpontok
Az API a következő fő végpontokat biztosítja:
Postafiókok kezelése
# Új postafiók létrehozása
curl -X POST https://api.evilmail.com/v1/inboxes
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "yourdomain.com", "prefix": "test"}'
# Postafiókok listázása
curl -X GET https://api.evilmail.com/v1/inboxes
-H "Authorization: Bearer YOUR_API_KEY"
# Postafiók törlése
curl -X DELETE https://api.evilmail.com/v1/inboxes/{inbox_id}
-H "Authorization: Bearer YOUR_API_KEY"Üzenetek kezelése
# Üzenetek lekérdezése
curl -X GET https://api.evilmail.com/v1/inboxes/{inbox_id}/messages
-H "Authorization: Bearer YOUR_API_KEY"
# Egyetlen üzenet lekérdezése
curl -X GET https://api.evilmail.com/v1/messages/{message_id}
-H "Authorization: Bearer YOUR_API_KEY"Válaszformátumok
Minden végpont JSON formátumban válaszol. A sikeres kérések 200 OK vagy 201 Created státuszkódot adnak vissza. A hibaválaszok tartalmazzák a hibakódot és az üzenetet:
{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Too many requests. Please retry after 60 seconds."
}
}Rate limiting
Az API rate limitet alkalmaz a visszaélések megelőzése érdekében. Az aktuális korlátokat a válasz fejlécekben találod:
- X-RateLimit-Limit: Az engedélyezett kérések száma az adott időablakban.
- X-RateLimit-Remaining: A hátralevő kérések száma.
- X-RateLimit-Reset: Az időablak lejáratának időbélyege.
Bevált gyakorlatok
- Használj exponential backoff stratégiát a rate limit hibák kezeléséhez.
- Implementálj webhook-okat a polling helyett, ha valós idejű értesítésekre van szükséged.
- Cacheld a válaszokat, ahol lehetséges, a kérések számának csökkentése érdekében.
- Mindig HTTPS-t használj az API-hívásokhoz.
Összefoglalás
Az EvilMail API egyszerű, RESTful felületet biztosít az eldobható e-mail funkciók integrálásához. Kövesd a dokumentációt és a bevált gyakorlatokat a zökkenőmentes integráció érdekében.