Introduction

YesWeCheck vérifie une adresse email et rend un verdict exploitable : peut-on lui écrire, et à quel risque ? Chaque validation enchaîne une série de contrôles (syntaxe, DNS, adresse jetable, faute de frappe, domaine piège, compte générique, dialogue SMTP…) et renvoie le détail de chacun.

Trois façons d'intégrer

Clé APIAPI serveur

Votre backend appelle POST /v2/email/validate et décide quoi faire de l'adresse.

Lire →Sans code serveurWidget de formulaire

Une balise script sans secret : vérification à la saisie, correction proposée, envoi bloqué si besoin.

Lire →Tableau de bordTraitement par lots

Un fichier CSV ou TXT jusqu'à 500 000 lignes, exporté en CSV, Excel, JSON ou PDF.

Lire →

Ce qui est accessible par clé API

L'API publique, celle qu'un serveur appelle avec une clé ywc_live_…, couvre la validation et les aides à la saisie :

Endpoint	Rôle	Authentification
POST /v2/email/validate	Valider une adresse	Clé API
POST /v2/email/enrich	Déduire prénom, nom, genre, âge présumé	Clé API
POST /v2/email/suggest/localpart	Proposer des parties locales à partir d'un nom	Clé API
POST /v2/email/suggest-firstname · suggest-lastname	Autocompléter un prénom, un nom	Clé API
GET /v2/email/suggest/domain/countries	Pays couverts par les suggestions de domaine	Clé API
POST /v2/email/suggest/domain	Autocompléter un domaine (gmail.com, orange.fr…)	Aucune
POST /v2/email/suggest/typo-domain	Détecter une faute de frappe dans le domaine	Aucune
GET /v2/billing/catalog	Plans et packs de crédits, prix HT	Aucune
GET /health	État de l'API	Aucune

Le détail de chaque endpoint est dans la référence API.

Ce qui se gère depuis le tableau de bord

La création des clés API, le traitement par lots, les widgets, les listes blanche et noire, les politiques de validation et la facturation se pilotent depuis app.yeswecheck.fr. Leurs routes HTTP n'acceptent qu'une session du tableau de bord : une clé API y reçoit 401. Elles ne font donc pas partie de l'API publique documentée ici.

L'essentiel en cinq points

1. Une base d'URL : https://api.yeswecheck.fr/v2. Seuls /health et /status sont servis hors du préfixe /v2.
2. Un en-tête : Authorization: Bearer ywc_live_…. L'en-tête X-API-Key n'est pas lu. Voir Authentification.
3. Le SMTP se règle sur la clé, pas dans la requête : une clé créée avec le SMTP activé l'exécute à chaque appel, une clé sans SMTP ne l'exécute jamais. Voir Contrôles.
4. Un crédit n'est débité que si le SMTP était activé et que le verdict final n'est pas unknown. Les autres contrôles sont gratuits. Voir Crédits.
5. Le verdict est dans result (valid, risky, invalid, unknown), accompagné d'un score de 0 à 100. Voir Verdicts et score.

Liens utiles

Tableau de bord	app.yeswecheck.fr
Statut de la plateforme	status.yeswecheck.fr
Spécification OpenAPI	docs.yeswecheck.fr/openapi.yaml
Support	[email protected]