📖 Documentation API

L'API MailTester est disponible pour les abonnés à partir du plan 50 vérifications/jour. Utilisez votre clé API dans le header X-API-Key.

🔐 Authentification

Toutes les requêtes API doivent inclure votre clé API dans le header HTTP :

X-API-Key: mt_your_api_key_here

Vous pouvez générer votre clé API depuis votre page compte.

📬 Endpoints

POST /api/v1/check

Vérifie une adresse email : syntaxe, DNS (MX), et SMTP. Retourne un score de 0 à 100.

Headers requis :

X-API-Key: mt_your_api_key_here Content-Type: application/json

Body (JSON) :

{ "email": "test@example.com" }

Réponse 200 :

{ "email": "test@example.com", "checks": { "syntax": { "status": "valid", "message": "Syntaxe valide", "detail": "Format RFC 5322 OK" }, "dns": { "status": "valid", "message": "Serveurs MX trouvés", "detail": "3 MX record(s)", "mx_records": ["aspmx.l.google.com", "alt1.aspmx.l.google.com"] }, "smtp": { "status": "valid", "message": "Serveur SMTP répond", "detail": "Connexion réussie", "server": "aspmx.l.google.com", "response_code": 220 } }, "overall_score": 95, "is_valid": true, "checked_at": "2026-07-20T12:00:00.000000" }

Erreurs :

401 — Clé API manquante ou invalide 403 — Abonnement insuffisant (plan 50+ requis) 429 — Limite quotidienne atteinte

⏱️ Limites

Plan	Vérifications / jour	Accès API
Gratuit	3	Non
Starter (10/j)	10	Non
Pro (50/j)	50	✓
Business (100/j)	100	✓
Enterprise (500/j)	500	✓

🧪 Exemple cURL

curl -X POST https://votre-domaine.com/api/v1/check \ -H "X-API-Key: mt_your_api_key_here" \ -H "Content-Type: application/json" \ -d '{"email": "test@example.com"}'