Prehled API
REST API EvilMail vam umoznuje integrovat funkcionalitu jednorazoveho e-mailu primo do vasi aplikace. At uz vyvijite system automatickeho testovani, SaaS platformu nebo interni nastroj, API poskytuje uplny programaticky pristup ke vsem funkcim EvilMail.
Autentizace
Vsechny API pozadavky vyzaduji autentizaci pomoci Bearer tokenu. Vygenerujte API klic z ovladaciho panelu EvilMail:
curl -X GET https://api.evilmail.com/v1/inboxes
-H "Authorization: Bearer YOUR_API_KEY"Udrzujte API klic v bezpeci. Nikdy jej nevkladejte primo do zdrojoveho kodu — pouzivejte promenne prostredi nebo spravce tajemstvi.
Hlavni endpointy
API poskytuje nasledujici endpointy:
Vytvoreni jednorazove schranky
curl -X POST https://api.evilmail.com/v1/inboxes
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "evilmail.com", "ttl": 3600}'Odpoved:
{
"id": "inbox_abc123",
"email": "[email protected]",
"created_at": "2026-03-12T10:00:00Z",
"expires_at": "2026-03-12T11:00:00Z"
}Vypis zprav
curl -X GET https://api.evilmail.com/v1/inboxes/inbox_abc123/messages
-H "Authorization: Bearer YOUR_API_KEY"Cteni konkretni zpravy
curl -X GET https://api.evilmail.com/v1/messages/msg_xyz789
-H "Authorization: Bearer YOUR_API_KEY"Smazani schranky
curl -X DELETE https://api.evilmail.com/v1/inboxes/inbox_abc123
-H "Authorization: Bearer YOUR_API_KEY"Webhooky
Namisto pollingu muzete nakonfigurovat webhooky pro prijem notifikaci v realnem case pri prichodu novych zprav:
curl -X POST https://api.evilmail.com/v1/webhooks
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"url": "https://vase-aplikace.cz/webhook/email", "events": ["message.received"]}'Zpracovani chyb
API vraci standardni stavove kody HTTP:
- 200 — Uspech
- 201 — Zdroj vytvoren
- 400 — Neplatny pozadavek
- 401 — Neautorizovano (neplatny nebo chybejici API klic)
- 404 — Zdroj nenalezen
- 429 — Prekrocen limit pozadavku
- 500 — Interni chyba serveru
Vzdy implementujte retry logiku s exponencialnim backoffem pro prechodne chyby (429, 500, 502, 503).
Limity pozadavku
API uplatnuje nasledujici limity pozadavku:
- Bezplatny plan: 100 pozadavku za minutu
- Plan Pro: 1 000 pozadavku za minutu
- Plan Enterprise: vlastni limity
Hlavicky odpovedi zahrnuji X-RateLimit-Remaining a X-RateLimit-Reset, ktere vam pomohou spravovat spotrebu.
Zaver
EvilMail API poskytuje vsechny nastroje potrebne k integraci jednorazovych e-mailu do jakekoli aplikace. S intuitivnimi endpointy, webhooky v realnem case a kompletni dokumentaci muzete budovat vykonné pracovni postupy pro testovani, overovani a spravu digitalni identity.