Valider une adresse
POST/v2/email/validate
Exécute les contrôles activés sur la clé et renvoie le verdict (result), le score (0 à 100) et le détail de chaque contrôle dans features.
- Répond toujours
200quand la validation aboutit, quel que soit le verdict. - Le SMTP est exécuté si, et seulement si, la clé l'a activé. Prévoyez un délai client de 30 s dans ce cas.
- Un contrôle désactivé sur la clé est absent de
features.syntaxetdnssont toujours présents. - Limite : 100 requêtes par minute et par IP.
Request
Responses
- 200
- 400
- 401
- 402
- 403
- 429
Validation effectuée.
Response Headers
RateLimit-Limit
Requêtes autorisées dans la fenêtre.
RateLimit-Remaining
Requêtes restantes dans la fenêtre.
RateLimit-Reset
Secondes avant la réinitialisation de la fenêtre.
Corps invalide ou champ inconnu. message est un tableau.
Authentification absente ou invalide : No authorization header, Invalid or revoked API key, Invalid authorization format.
Solde épuisé alors que le SMTP est activé sur la clé. Rien n'est débité.
IP ou origine non autorisée pour la clé, ou contrôle anti-abus du widget.
Trois cas, tous avec Retry-After :
- limite de débit par IP : corps en texte brut ;
- plafond de crédits de la clé : JSON,
code: API_KEY_BUDGET_EXCEEDED; - anti-abus du widget : JSON.
Response Headers
Retry-After
Secondes à attendre avant de réessayer.