API de validation email hébergée en Europe

L'API de validation email de YesWeCheck analyse une adresse et renvoie un statut, les raisons qui le motivent et un score de risque. Dix-neuf contrôles s'exécutent par adresse, dix-huit sans consommer de crédit. La vérification SMTP est le seul contrôle facturé. L'infrastructure de validation est hébergée en France et en Allemagne.

L'authentification passe par l'en-tête Authorization, avec le schéma Bearer, pour une clé API comme pour un jeton de session. L'en-tête X-API-Key n'est jamais lu par le serveur. Une clé de production commence par un préfixe distinct de celui d'une clé de test, ce qui rend les deux environnements impossibles à confondre.

La réponse porte un statut global, un score et le détail contrôle par contrôle. Chaque contrôle rend son propre résultat, son propre score et un message lisible. Les métadonnées indiquent le nombre de crédits débités par l'appel. Un client peut donc décider sur le statut seul, ou remonter jusqu'au signal exact qui l'a produit.

Chaque adresse soumise traverse dix-neuf contrôles nommés. Dix-huit s'exécutent en parallèle et n'ont aucun coût : syntaxe, DNS, domaines jetables, typosquatting, comptes de rôle, santé du domaine. Le dix-neuvième, la vérification SMTP, interroge le serveur destinataire, prend beaucoup plus de temps et consomme un crédit.

Une seule information est obligatoire : l'adresse à analyser. Les autres paramètres activent la vérification SMTP, l'enrichissement d'identité, ou ajustent le délai accordé au serveur destinataire. Sans le paramètre qui demande la vérification SMTP, l'appel n'entraîne jamais de débit, quelle que soit la réponse rendue.

Le même moteur sert deux usages. En temps réel, une requête porte une adresse et la réponse revient dans l'appel, ce qui convient à un formulaire d'inscription. En traitement par lots, un fichier est déposé, traité de façon asynchrone puis restitué ligne par ligne, ce qui convient au nettoyage d'une base existante.

La vérification SMTP ouvre une session avec le serveur destinataire, lui annonce l'expéditeur et le destinataire, puis s'arrête avant d'écrire le message. Aucun courrier n'arrive dans la boîte analysée. C'est le seul contrôle facturé, et il ne l'est que lorsque le serveur permet réellement de conclure.

Chaque adresse reçoit un statut parmi quatre et un score de zéro à cent. Le statut dit ce qu'il faut faire de l'adresse, le score dit avec quelle confiance. Un résultat techniquement acceptable dont le score descend sous le seuil de dégradation est rendu comme risqué plutôt que comme valide.

Une intégration robuste distingue quatre situations d'échec : le jeton refusé, le solde de crédits épuisé, le paramètre hors bornes et le plafond de la clé atteint. Aucune n'est une erreur du serveur, chacune appelle une action différente. Le solde épuisé, en particulier, n'empêche pas les dix-huit contrôles gratuits.

YesWeCheck héberge son infrastructure de validation chez OVHcloud, en France et en Allemagne. Les adresses soumises sont traitées sur cette infrastructure, et aucun message n'est envoyé au destinataire pendant la vérification. Aucune certification formelle n'est revendiquée ici : seules des mesures techniques vérifiables sont décrites.

La structure de coût tient en une phrase : un crédit est débité si et seulement si la vérification SMTP a été demandée et que le statut final permet de conclure. Les dix-huit autres contrôles s'exécutent sans quota. Cent vérifications SMTP sont offertes une fois, à l'inscription, sans carte bancaire.

Trois limites sont structurelles et aucun fournisseur ne les contourne. Un domaine qui accepte toutes les adresses rend l'existence d'une boîte indécidable. Une temporisation du serveur destinataire empêche de conclure dans l'instant. Et un serveur peut accepter une adresse aujourd'hui puis la refuser demain, sans prévenir.

Créer un compte suffit pour obtenir une clé API et cent vérifications SMTP offertes. Aucune carte bancaire n'est demandée. La documentation publie les schémas de réponse, les codes d'erreur et les exemples d'intégration par langage. Tant que la vérification SMTP n'est pas demandée, aucun crédit n'est consommé.