Inleiding
Met de EvilMail REST API kun je wegwerp-e-mailfunctionaliteit rechtstreeks in je applicatie integreren. Of het nu gaat om geautomatiseerd testen, gebruikersregistratieprocessen of e-mailgebaseerde workflows ā de API dekt alles.
Authenticatie
Alle API-verzoeken vereisen Bearer-tokenauthenticatie. Je API-sleutel vind je in de EvilMail-gebruikersinterface onder Instellingen > API.
curl -X GET https://api.evilmail.com/v1/account
-H "Authorization: Bearer YOUR_API_KEY"Behandel je API-sleutel vertrouwelijk. Sla deze nooit op in de broncode ā gebruik omgevingsvariabelen of een secret manager.
Belangrijkste endpoints
De API biedt de volgende belangrijkste endpoints:
Inboxbeheer
# Nieuwe inbox aanmaken
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"}'
# Inboxen opvragen
curl -X GET https://api.evilmail.com/v1/inboxes
-H "Authorization: Bearer YOUR_API_KEY"
# Inbox verwijderen
curl -X DELETE https://api.evilmail.com/v1/inboxes/{inbox_id}
-H "Authorization: Bearer YOUR_API_KEY"Berichtenbeheer
# Berichten opvragen
curl -X GET https://api.evilmail.com/v1/inboxes/{inbox_id}/messages
-H "Authorization: Bearer YOUR_API_KEY"
# Enkel bericht opvragen
curl -X GET https://api.evilmail.com/v1/messages/{message_id}
-H "Authorization: Bearer YOUR_API_KEY"Responsformaten
Alle endpoints retourneren JSON. Succesvolle verzoeken geven een 200 OK of 201 Created statuscode terug. Foutresponsen bevatten de foutcode en het bericht:
{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Too many requests. Please retry after 60 seconds."
}
}Rate limiting
De API past rate limiting toe om misbruik te voorkomen. De huidige limieten vind je in de responsheaders:
- X-RateLimit-Limit: Het aantal toegestane verzoeken in het huidige tijdvenster.
- X-RateLimit-Remaining: Het aantal resterende verzoeken.
- X-RateLimit-Reset: De timestamp waarop het tijdvenster verloopt.
Best practices
- Gebruik een exponential-backoffstrategie voor het afhandelen van rate-limitfouten.
- Implementeer webhooks in plaats van polling als je realtime meldingen nodig hebt.
- Cache responses waar mogelijk om het aantal verzoeken te verminderen.
- Gebruik altijd HTTPS voor API-aanroepen.
Samenvatting
De EvilMail API biedt een eenvoudige, RESTful interface voor het integreren van wegwerp-e-mailfunctionaliteit. Volg de documentatie en best practices voor een vlekkeloze integratie.