Apprenez a creer des e-mails temporaires, lire des boites de reception et gerer des domaines par programmation via notre API REST.
EvilMail Team1 février 202610 min de lecture
Premiers pas avec l'API
L'API EvilMail vous permet d'automatiser la gestion de vos e-mails temporaires directement depuis votre application. Que vous developpiez un outil de test, un systeme de verification ou une plateforme d'automatisation, l'API REST vous offre un acces complet a toutes les fonctionnalites d'EvilMail.
Obtenir votre cle API
Pour utiliser l'API, vous devez d'abord generer une cle API depuis votre tableau de bord EvilMail. Rendez-vous dans Parametres > API et cliquez sur « Generer une nouvelle cle ». Conservez cette cle en lieu sur : elle sera incluse dans l'en-tete Authorization de chaque requete.
Authorization: Bearer YOUR_API_KEY
Creer un e-mail temporaire
Pour creer une nouvelle adresse e-mail temporaire, envoyez une requete POST au endpoint dedie :
La reponse contient l'adresse e-mail generee, sa date d'expiration et un identifiant unique. Le parametre ttl (time-to-live) definit la duree de vie de l'adresse en secondes.
Lire la boite de reception
Pour consulter les e-mails recus sur une adresse temporaire, effectuez une requete GET :
curl -X GET https://evilmail.com/api/inbox/[email protected]
-H "Authorization: Bearer YOUR_API_KEY"
La reponse inclut la liste des messages avec leur expediteur, leur objet, leur contenu (texte et HTML), les pieces jointes et les horodatages. Vous pouvez egalement filtrer les messages par date ou par expediteur a l'aide de parametres de requete.
Gestion des domaines
L'API vous permet egalement de gerer vos domaines personnalises par programmation :
# Lister les domaines
curl -X GET https://evilmail.com/api/domains
-H "Authorization: Bearer YOUR_API_KEY"
# Ajouter un domaine
curl -X POST https://evilmail.com/api/domains
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "mondomaine.com"}'
# Verifier le statut DNS
curl -X GET https://evilmail.com/api/domains/mondomaine.com/status
-H "Authorization: Bearer YOUR_API_KEY"
Cas d'utilisation courants
Tests automatises : Creez des adresses uniques pour chaque execution de test et verifiez la reception des e-mails transactionnels.
Verification d'utilisateurs : Integrez la creation d'e-mails temporaires dans vos flux d'inscription pour les utilisateurs qui ne souhaitent pas communiquer leur adresse principale.
Surveillance : Mettez en place des controles reguliers de la delivrabilite de vos e-mails en envoyant des messages de test vers des adresses temporaires et en verifiant leur reception.
Protection de la vie privee : Offrez a vos utilisateurs la possibilite de generer des adresses jetables directement depuis votre application.
Gestion des erreurs et limites
L'API utilise les codes HTTP standards. Les erreurs courantes incluent le code 401 (cle API invalide), 404 (adresse ou domaine introuvable) et 429 (limite de debit atteinte). Consultez la documentation de l'API pour connaitre les limites de debit et les bonnes pratiques d'integration.
