Passer au contenu principal
L’API de vérification de l’e-mail propose un flux en deux étapes : envoyer un code à usage unique à une adresse e-mail, puis vérifier le code saisi par l’utilisateur. Le système effectue également une évaluation des risques, notamment l’exposition à des fuites de données, la détection des fournisseurs d’e-mails jetables et les contrôles de délivrabilité.

Endpoints

Envoyer le code e-mail

POST /v3/email/send/ — Envoyer un code de vérification à usage unique à une adresse e-mail.

Vérifier le code e-mail

POST /v3/email/check/ — Vérifier le code et récupérer les données de risque liées à l’e-mail.

Évaluer le risque e-mail

POST /v3/email/risk/ — Évaluer le risque de délivrabilité, de fuite de données et d’e-mail jetable, sans envoyer de code.

Fonctionnement

  1. Appelez Envoyer le code e-mail avec l’adresse e-mail cible
  2. L’utilisateur reçoit un code à 6 chiffres (valable 5 minutes)
  3. Appelez Vérifier le code e-mail avec l’e-mail et le code
  4. Recevez le résultat de la vérification ainsi que les signaux de risque (exposition à des fuites de données, fournisseur jetable, délivrabilité)
Par défaut, les e-mails OTP autonomes utilisent l’identité visuelle de Didit. Pour utiliser l’expéditeur et l’identité visuelle en marque blanche configurés pour votre application lors d’une session de vérification d’e-mail autonome donnée, transmettez options.use_white_label_customization: true à POST /v3/email/send/. La valeur par défaut est false.

Signaux de risque

La réponse de la vérification contient : Pour la structure complète de la réponse, voir Rapport de vérification de l’e-mail.
Dernière modification le 7 novembre 2026