Passer en production

Liste de contrôle

• La clé de production est dans une variable d'environnement ou un coffre-fort de secrets, jamais dans le code.
• Une clé distincte par application et par environnement.
• Clés serveur restreintes par IP quand vos IP de sortie sont fixes.
• Plafond de crédits journalier sur toute clé avec SMTP.
• Contrôle network désactivé sur les clés serveur (il analyserait votre propre serveur).
• Délai d'attente client adapté (voir ci-dessous).
• Mode dégradé : une indisponibilité de l'API n'empêche pas vos utilisateurs de s'inscrire.
• Les erreurs 401, 402, 403 déclenchent une alerte chez vous : elles demandent une action humaine.
• metadata.requestId est journalisé avec l'adresse validée.
• Les alertes de solde sont activées (Paramètres → Notifications).

Délais d'attente

Appel	Délai client conseillé
POST /v2/email/validate, clé sans SMTP	10 s
POST /v2/email/validate, clé avec SMTP	30 s
Endpoints de suggestion et d'enrichissement	5 s

La plupart des réponses arrivent bien plus vite. Le délai long protège des serveurs de messagerie lents, dont la réponse finit souvent en unknown.

Nouvelles tentatives

Situation	Réessayer ?
429 avec Retry-After	Oui, après le nombre de secondes indiqué
500, 502, 503, 504, délai dépassé	Oui, une ou deux fois, avec un délai croissant (2 s, puis 8 s)
400, 401, 402, 403, 404	Non : corrigez l'appel, la clé ou le solde
Verdict unknown	Oui, plus tard (quelques minutes à quelques heures) : greylisting et serveurs lents se résolvent souvent

Un appel répété est validé, et facturé, de nouveau : ne relancez pas automatiquement un appel qui a réussi.

Mise en cache

Une adresse change rarement d'état d'un jour à l'autre. Mettez vos résultats en cache, clé = adresse normalisée en minuscules :

Verdict	Durée raisonnable
valid	7 à 30 jours
invalid	7 à 30 jours
risky	7 jours
unknown	Pas de cache, ou quelques heures

YesWeCheck garde aussi en cache les résultats SMTP récents de son côté ; votre cache évite en plus l'aller-retour réseau et le crédit.

Débit

POST /v2/email/validate accepte 100 requêtes par minute et par IP. Au-delà de quelques centaines d'adresses à traiter d'un coup, utilisez le traitement par lots : il répartit la charge entre fournisseurs et produit un rapport. Voir Limites de débit.

Suivi

• Statistiques par clé dans le tableau de bord : appels, erreurs, crédits consommés, tentatives refusées par les restrictions d'IP ou d'origine.
• Alertes : solde bas, solde épuisé, plafond de clé à 50, 80 et 100 %.
• État de la plateforme : status.yeswecheck.fr, et GET https://api.yeswecheck.fr/health pour vos sondes.