Les contrôles
Une validation enchaîne une quinzaine de contrôles. La syntaxe passe en premier : une adresse mal formée s'arrête là, sans aucune requête réseau. Les autres contrôles tournent ensuite en parallèle, le SMTP en dernier.
Vue d'ensemble
| Contrôle | Ce qu'il vérifie | Coût | Réglage sur la clé |
|---|---|---|---|
| Syntaxe | Forme de l'adresse, domaines internationalisés, normalisation | Gratuit | Toujours actif |
| DNS | Le domaine a-t-il un serveur de messagerie (MX, ou enregistrement A de repli) | Gratuit | Toujours actif |
| SMTP | La boîte existe-t-elle : dialogue avec le serveur du destinataire, sans envoyer de message | 1 crédit si conclusif | smtp, désactivé par défaut |
| Accept-all | Le serveur accepte-t-il n'importe quelle adresse | Inclus dans le SMTP | avec smtp |
| Jetable | Domaine de boîtes temporaires | Gratuit | disposable |
| Domaine malveillant | Hameçonnage, arnaques, listes noires publiques | Gratuit | maliciousDomains |
| Faute de frappe | gmial.com, hotmial.fr, orange.fe… | Gratuit | typoDomain |
| Correction vérifiée | Sonde de l'adresse corrigée quand l'adresse saisie est douteuse | Gratuit | avec typoDomain et smtp |
| Domaine piège | Domaine enregistré pour imiter un fournisseur et capter son courrier | Gratuit | typosquat |
| Compte générique | contact@, info@, support@, admin@… | Gratuit | roleAccount |
| Partie locale aléatoire | x7k3p9q2@… | Gratuit | randomDetection |
| Terme injurieux | Insulte dans la partie locale (les prénoms qui en contiennent une, comme Dominique, sont exclus) | Gratuit | profanity |
| Sous-adressage | [email protected] et équivalents par fournisseur | Gratuit | aliasing |
| Enrichissement | Prénom, nom, genre, âge présumé déduits de la partie locale | Gratuit | enrichment |
| Listes de l'organisation | Liste blanche et liste noire | Gratuit | whitelist, blacklist |
| Santé du domaine | MX, SPF, DMARC, âge du domaine | Gratuit | domainHealth |
| Réseau | IP de l'appelant : Tor, VPN, hébergeur, pays | Gratuit | network |
Les réglages se font dans Clés API du tableau de bord. Un contrôle désactivé n'est plus calculé pour cette clé et disparaît de la réponse.
Le SMTP en détail
Le SMTP est le seul contrôle qui confirme qu'une boîte existe. YesWeCheck se connecte au serveur de messagerie du domaine, se présente, annonce un destinataire et lit la réponse, puis raccroche avant tout envoi. Aucun message n'arrive jamais dans la boîte.
- Durée : de quelques centaines de millisecondes à une quinzaine de secondes selon le serveur. Prévoyez un délai d'attente client d'au moins 30 secondes sur les clés avec SMTP.
smtpTimeout: facultatif, en millisecondes (1 000 à 30 000), il borne l'attente des réponses du serveur distant. Sans valeur, la plateforme applique son propre réglage, adapté à chaque messagerie.- Cache : un résultat SMTP récent pour la même adresse peut être réutilisé, ce qui accélère la réponse et ménage les serveurs distants.
- Microsoft 365 et Outlook : certaines boîtes Microsoft sont vérifiées par une méthode dédiée plutôt que par un dialogue SMTP classique ; le résultat a le même sens (
MS_ACCOUNT_EXISTSdansreasonCode). - Ce qui n'est pas facturé : un SMTP qui conclut unknown (accept-all, greylisting, délai dépassé), une adresse en liste blanche ou noire (le SMTP n'est alors pas exécuté).
Ce qui est facturé : tout verdict final valid, risky ou invalid obtenu avec une clé dont le SMTP est activé, y compris quand le verdict tombe avant le dialogue (syntaxe fausse, domaine sans serveur). Voir Crédits.
L'enrichissement en détail
À partir de la partie locale (jean.dupont@…), YesWeCheck déduit un prénom et un nom probables, puis un genre et un âge présumé à partir des statistiques de naissances (INSEE pour la France, sources nationales équivalentes pour d'autres pays).
Le pays de référence pour l'âge est choisi ainsi :
- le champ
countryde la requête s'il est fourni (FR,US,DEU…) ; - sinon l'extension nationale du domaine (
.de,.it…) ; - sinon la France.
Sans données d'âge pour le pays retenu, presumedAge est absent plutôt que faux. Ces informations sont des estimations statistiques : elles aident à personnaliser ou à segmenter, jamais à décider seules.
L'enrichissement seul, sans validation, est disponible sur POST /v2/email/enrich.