Vérifier une adresse

Ce guide explique comment contrôler une adresse e-mail, soit manuellement dans le tableau de bord, soit depuis votre code via l’API. Il montre aussi comment utiliser la vérification dans un formulaire d’inscription pour bloquer les fautes de frappe et les adresses jetables avant qu’elles n’arrivent dans votre liste.

Avant de commencer

• Chaque vérification coûte 5 crédits. Consultez votre solde dans la barre latérale ou dans Workspace›Billing.
• Pour l’API, utilisez une clé API Full Access. Les clés d’envoi uniquement ne peuvent pas vérifier d’adresses.

Mode rapide et mode complet

Les deux modes coûtent le même prix. full prend plus de temps parce qu’il dialogue avec le serveur de messagerie du destinataire, qui peut être lent ou refuser de répondre. Certains grands fournisseurs bloquent ces contrôles : full ne peut donc pas toujours confirmer une boîte aux lettres. Pour la signification de chaque contrôle, consultez Résultats de vérification.

Vérifier une adresse

curl https://api.emailit.com/v2/email-verifications \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.com", "mode": "full" }'

{
  "id": "ev_6Hq2Lm9Tx4Pz",
  "object": "email_verification",
  "email": "ada@example.com",
  "status": "completed",
  "score": 100,
  "risk": "low",
  "result": "safe",
  "mode": "full",
  "checks": {
    "valid_syntax": true,
    "disposable": false,
    "role_account": false,
    "inbox_full": false,
    "deliverable": true,
    "disabled": false,
    "free_email": false,
    "gibberish": false,
    "catch_all": false,
    "smtp_connect": true,
    "has_mx_records": true,
    "domain_age": 10957
  },
  "address": {
    "mailbox": "ada",
    "domain": "example.com",
    "suffix": null,
    "root": "ada@example.com"
  },
  "did_you_mean": null,
  "mx_records": [
    { "priority": 10, "exchange": "mx1.example.com" }
  ],
  "created_at": "2026-10-01T10:24:11Z",
  "updated_at": "2026-10-01T10:24:11Z"
}

Vérifier les adresses à l’inscription

Contrôler une adresse au moment où quelqu’un la saisit est le moyen le moins coûteux de garder une liste propre. Une faute de frappe repérée à l’inscription ne devient jamais un rebond.

1. Appelez l’API depuis votre serveur. Ne placez jamais votre clé API dans du code exécuté par le navigateur. Envoyez l’adresse depuis le gestionnaire d’inscription de votre serveur, en mode fast.

2. Définissez un timeout et laissez passer en cas d’échec. Si la vérification est lente ou renvoie une erreur, acceptez l’inscription. Perdre un vrai client coûte plus cher qu’une mauvaise adresse.

3. Agissez selon le résultat. Bloquez ce qui est manifestement erroné, suggérez des corrections pour les fautes de frappe et laissez passer tout le reste.

export async function checkSignupEmail(email) {
  const controller = new AbortController();
  const timer = setTimeout(() => controller.abort(), 5000);

  try {
    const res = await fetch('https://api.emailit.com/v2/email-verifications', {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ email, mode: 'fast' }),
      signal: controller.signal,
    });
    if (!res.ok) return { ok: true }; // fail open

    const verification = await res.json();

    if (verification.result === 'invalid') {
      return {
        ok: false,
        message: verification.did_you_mean
          ? `Did you mean ${verification.did_you_mean}?`
          : 'Please check your email address.',
      };
    }
    if (verification.result === 'disposable') {
      return { ok: false, message: 'Please use a permanent email address.' };
    }

    // Accept the address, but offer a correction if one looks likely.
    return { ok: true, suggestion: verification.did_you_mean };
  } catch {
    return { ok: true }; // timeout or network error: fail open
  } finally {
    clearTimeout(timer);
  }
}

Quelques conseils :

• Utilisez did_you_mean. Pour les fautes de frappe courantes dans le domaine, comme ada@gmial.com, ce champ contient l’adresse probable, ada@gmail.com. Affichez-la comme une suggestion que la personne peut accepter.
• Ne bloquez pas d’office les adresses génériques. Les petites entreprises s’inscrivent souvent avec info@ ou sales@. Signalez-les plutôt.
• Vérifiez chaque adresse une seule fois. Chaque appel coûte des crédits : vérifiez à l’envoi du formulaire, pas à chaque frappe, et enregistrez le résultat.

Voir aussi