Prezentare generala a API-ului
API-ul REST EvilMail iti permite sa integrezi functionalitatea de e-mail temporar direct in aplicatia ta. Fie ca dezvolti un sistem de testare automata, o platforma SaaS sau un instrument intern, API-ul ofera acces programatic complet la toate functiile EvilMail.
Autentificare
Toate cererile API necesita autentificare prin token Bearer. Genereaza cheia API din panoul de control EvilMail:
curl -X GET https://api.evilmail.com/v1/inboxes
-H "Authorization: Bearer YOUR_API_KEY"Pastreaza cheia API in siguranta. Nu o include niciodata direct in codul sursa — foloseste variabile de mediu sau un manager de secrete.
Endpoint-uri principale
API-ul ofera urmatoarele endpoint-uri:
Crearea unei casute temporare
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}'Raspuns:
{
"id": "inbox_abc123",
"email": "[email protected]",
"created_at": "2026-03-12T10:00:00Z",
"expires_at": "2026-03-12T11:00:00Z"
}Listarea mesajelor
curl -X GET https://api.evilmail.com/v1/inboxes/inbox_abc123/messages
-H "Authorization: Bearer YOUR_API_KEY"Citirea unui mesaj specific
curl -X GET https://api.evilmail.com/v1/messages/msg_xyz789
-H "Authorization: Bearer YOUR_API_KEY"Stergerea unei casute
curl -X DELETE https://api.evilmail.com/v1/inboxes/inbox_abc123
-H "Authorization: Bearer YOUR_API_KEY"Webhook-uri
In loc de polling, poti configura webhook-uri pentru a primi notificari in timp real cand sosesc mesaje noi:
curl -X POST https://api.evilmail.com/v1/webhooks
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"url": "https://app-ul-tau.com/webhook/email", "events": ["message.received"]}'Gestionarea erorilor
API-ul returneaza coduri de stare HTTP standard:
- 200 — Succes
- 201 — Resursa creata
- 400 — Cerere invalida
- 401 — Neautorizat (cheie API invalida sau lipsa)
- 404 — Resursa negasita
- 429 — Limita de rata depasita
- 500 — Eroare interna de server
Implementeaza intotdeauna retry logic cu backoff exponential pentru erorile tranzitorii (429, 500, 502, 503).
Limite de rata
API-ul aplica urmatoarele limite de rata:
- Planul gratuit: 100 de cereri pe minut
- Planul Pro: 1.000 de cereri pe minut
- Planul Enterprise: limite personalizate
Header-ele de raspuns includ X-RateLimit-Remaining si X-RateLimit-Reset pentru a te ajuta sa gestionezi consumul.
Concluzie
API-ul EvilMail ofera toate instrumentele necesare pentru a integra e-mailuri temporare in orice aplicatie. Cu endpoint-uri intuitive, webhook-uri in timp real si o documentatie completa, poti construi fluxuri de lucru puternice pentru testare, verificare si gestionarea identitatii digitale.