Documentation API
Intégrez EvilMail dans vos applications
Aperçu
L'API EvilMail fournit un accès programmatique à toutes les fonctionnalités de la plateforme.
API E-mail temporaire
Créez des boîtes jetables, lisez les messages, expiration automatique
API Domaines et E-mails
Domaines personnalisés, comptes e-mail, gestion DNS
Extraction Regex
Extraction automatique des codes de vérification de 8+ services
Official SDK Libraries
Format de réponse
Toutes les réponses suivent une structure JSON cohérente :
{
"status": "success" | "error",
"message": "Human-readable message (optional)",
"messageKey": "i18n key for localized errors (optional)",
"data": { ... }
}Les réponses d'erreur incluent messageKey pour les messages d'erreur localisés.
Authentification
Toutes les requêtes API nécessitent une clé API transmise via l'en-tête X-API-Key. Obtenez votre clé API depuis le tableau de bord après inscription.
Clé API
Pour la création d'e-mails temporaires et l'extraction de codes de vérification. Nécessite un abonnement payant actif.
X-API-Key: your_64char_hex_keyCookie de session
Pour les endpoints de gestion des domaines, comptes e-mail et DNS. Défini après la connexion.
Cookie: evilmail_session=...L'API e-mail temporaire nécessite un plan payant
L'API e-mail temporaire et les endpoints d'extraction regex nécessitent un abonnement actif.
E-mail temporaire
Plan payant requisCréez des adresses e-mail jetables avec un TTL configurable. Domaines disponibles: evilmail.pro, evilmail.cloud.
Create a temporary email address
domainstringoptionnelDomain to use (default: evilmail.pro)ttlMinutesnumberoptionnelLifetime: 10, 30, 60, 360, 1440 (default: 60){
"status": "success",
"data": {
"email": "[email protected]",
"domain": "evilmail.pro",
"sessionToken": "a1b2c3d4...",
"ttlMinutes": 60,
"expiresAt": "2026-03-07T15:30:00.000Z"
}
}Available domains: evilmail.pro, evilmail.cloud. Requires an active paid subscription.
Boîte de réception et messages
Lisez les e-mails entrants de votre boîte temporaire. Les messages sont récupérés via IMAP en temps réel.
Gestion des domaines
Enregistrez des domaines personnalisés, vérifiez le DNS et gérez votre infrastructure e-mail.
Comptes e-mail
Créez, listez et gérez les comptes e-mail sous vos domaines vérifiés.
Extraction intelligente de codes de vérification
Clé APIExtraction automatique des codes de vérification des e-mails entrants. Parfait pour les tests automatisés et CI/CD.
Extract verification code from the latest email
servicestringrequisService name (see supported list)emailstringrequisEmail address to search (query param){
"status": "success",
"data": {
"code": "847291",
"service": "google",
"email": "[email protected]",
"from": "[email protected]",
"subject": "Your verification code",
"date": "2026-03-07T14:22:00.000Z"
}
}Searches the last 20 messages. You must own the domain.
Services pris en charge
| Service | Endpoint | Modèle de code | Domaines d'envoi |
|---|---|---|---|
| /api/regex/google | G-XXXXXX | google.com, accounts.google.com | |
| /api/regex/facebook | XXXXXX | facebookmail.com, facebook.com | |
| Twitter/X | /api/regex/twitter | XXXXXXXX | twitter.com, x.com |
| /api/regex/instagram | XXXXXX | instagram.com, mail.instagram.com | |
| TikTok | /api/regex/tiktok | XXXX-XXXXXX | tiktok.com |
| Discord | /api/regex/discord | XXXXXX | discord.com |
| /api/regex/linkedin | XXXXXX | linkedin.com | |
| iCloud | /api/regex/icloud | XXXXXX | apple.com, id.apple.com |
Besoin d'un autre service ?
Si le service que vous cherchez n'est pas listé ci-dessus, faites-le nous savoir.
Contactez-nous# Extract Google verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
-H "X-API-Key: YOUR_API_KEY"
# Extract Discord verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
-H "X-API-Key: YOUR_API_KEY"
# Extract TikTok code
curl "https://evilmail.pro/api/regex/[email protected]" \
-H "X-API-Key: YOUR_API_KEY"Gestion DNS
Gestion complète des enregistrements DNS via PowerDNS. Prend en charge les types A, AAAA, CNAME, MX, TXT, NS, SRV et CAA.
Exemples de code
Exemples complets pour créer des e-mails temporaires, lire les boîtes de réception et extraire les codes de vérification.
Flux e-mail temporaire
# Create a temporary email
curl -X POST https://evilmail.pro/api/temp-email \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"domain": "evilmail.pro", "ttlMinutes": 60}'
# Response: { "data": { "email": "...", "sessionToken": "abc123..." } }
# Poll for incoming messages using the session token
curl https://evilmail.pro/api/temp-email/abc123...
# Response includes messages array
# { "data": { "email": "...", "messages": [...] } }Extraction de codes de vérification
# Extract Google verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
-H "X-API-Key: YOUR_API_KEY"
# Extract Discord verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
-H "X-API-Key: YOUR_API_KEY"
# Extract TikTok code
curl "https://evilmail.pro/api/regex/[email protected]" \
-H "X-API-Key: YOUR_API_KEY"Exemples de gestion de domaines
# Add a domain
curl -X POST https://evilmail.pro/api/domains \
-H "Content-Type: application/json" \
-H "Cookie: evilmail_session=YOUR_SESSION" \
-d '{"domain": "mydomain.com"}'
# List domains
curl https://evilmail.pro/api/domains \
-H "Cookie: evilmail_session=YOUR_SESSION"
# Verify DNS
curl -X POST https://evilmail.pro/api/domains/check \
-H "Content-Type: application/json" \
-H "Cookie: evilmail_session=YOUR_SESSION" \
-d '{"domain": "mydomain.com"}'
# Create email account
curl -X POST https://evilmail.pro/api/accounts \
-H "Content-Type: application/json" \
-H "Cookie: evilmail_session=YOUR_SESSION" \
-d '{"email": "[email protected]", "password": "secure123"}'Limites et plans
Limites du plan
| Fonctionnalité | Free | Bronze | Gold | Premium |
|---|---|---|---|---|
| Domaines personnalisés | 1 | 5 | 25 | 999 |
| E-mails / domaine | 5 | 999 | 999 | 999 |
| API E-mail temporaire | Web uniquement | Complet | Complet | Complet |
| API Regex | Web uniquement | Complet | Complet | Complet |
| Limite de débit API | 100/hr | 1,000/hr | 5,000/hr | Illimité |
| Sessions temporaires / IP | 10 | 10 | 10 | 10 |
Limites de débit des endpoints
Par adresse IP
POST /api/auth/login10 / 15 minPOST /api/auth/register5 / 1 hourPOST /api/auth/forgot-password3 / 1 hourPOST /api/auth/reset-password5 / 15 minPUT /api/account/password5 / 15 minPOST /api/contact5 / 1 hourPOST /api/temp-email10 sessions / IPGET /api/regex/{service}Basé sur le planGestion des erreurs
Toutes les réponses d'erreur incluent un champ status, un message lisible et un messageKey optionnel.
{
"status": "error",
"message": "Domain limit reached. Upgrade your plan for more.",
"messageKey": "domainLimitReached"
}| Code | Statut | Description |
|---|---|---|
| 200 | Success | Request completed successfully |
| 400 | Bad Request | Missing or invalid parameters |
| 401 | Unauthorized | Invalid or missing authentication |
| 403 | Forbidden | Insufficient permissions or plan limits |
| 404 | Not Found | Resource does not exist |
| 409 | Conflict | Resource already exists (duplicate) |
| 429 | Rate Limited | Too many requests, slow down |
| 500 | Server Error | Internal server error |
Messages d'erreur localisés
Utilisez le champ messageKey pour afficher les erreurs dans la langue préférée de l'utilisateur.
Explorateur API
Testez les endpoints API directement depuis votre navigateur. Entrez votre clé API et envoyez des requêtes pour voir les réponses en direct.
https://evilmail.pro/api/temp-emaildomainttlMinutesPrêt à intégrer ?
Obtenez votre clé API depuis le tableau de bord et commencez à construire.

