Envoyez une adresse et obtenez un verdict : valid, neutral, risky, undeliverable ou typo. Avec celui-ci, un score de confiance de 0 à 100, les indicateurs qui précisent le type d'adresse, et l'adresse que la faute de frappe était censée être. Une requête, pas de liste à importer ni de tâche à interroger.
const answer = await bird.lookup.email({
email: "aisha.khan@exampel.com",
});
console.log(answer.result, answer.delivery_confidence);
// → "typo" 31
console.log(answer.did_you_mean);
// → "aisha.khan@example.com"
console.log(answer.valid, answer.flags);
// → true []
Un verdict sur lequel brancher votre logique.
Pas un pourcentage pour lequel vous devez choisir un seuil.
La recherche d'adresse e-mail est l'une des deux opérations de l<hub>API Bird Lookup</hub>. Le champ sur lequel écrire votre logique est <code>result</code>, car il réduit déjà les vérifications de syntaxe, de domaine, de boîte aux lettres et de réputation à cinq résultats. <code>delivery_confidence</code> est là pour les cas où vous souhaitez noter plutôt que bloquer, par exemple mettre en attente une inscription à risque pour examen au lieu de la refuser. Ladresse envoyée est l'adresse renvoyée : la partie locale est sensible à la casse et n'est pas convertie en minuscules, et le format display-name est rejeté plutôt qu'analysé.
Six champs, et à quoi chacun sert.
Chacun d'entre eux arrive avec la même requête unique.
- 01
result, le verdict.
valid signifie que l'envoi est sûr. neutral est délivrable sans rien de particulier à signaler. risky acceptera probablement le courrier et comporte une raison d'hésiter. undeliverable ne peut pas recevoir de courrier. typo ressemble à une faute de frappe d'une adresse réelle.
- 02
reason, uniquement quand c'est pertinent.
invalid_syntax, invalid_domain ou invalid_recipient, indiquant laquelle des trois vérifications l'adresse a échouée. Présent uniquement avec le verdict undeliverable et aucun autre, donc son absence est aussi une information.
- 03
did_you_mean, la correction.
L'adresse dont un typo semble être la faute de frappe, prête à être présentée à la personne qui l'a saisie. Un formulaire d'inscription qui propose la correction récupère le compte au lieu de le perdre dans un rebond que personne ne voit.
- 04
delivery_confidence, de 0 à 100.
Une note plutôt qu'une décision, c'est ce qui le distingue de result. Deux adresses peuvent partager un verdict et être très éloignées sur ce nombre, et cet écart est l'endroit où une file d'attente de révision a sa place.
- 05
flags, le type d'adresse.
role pour une boîte aux lettres partagée comme info ou support, disposable pour un fournisseur d'adresses jetables, et free_provider pour une boîte aux lettres grand public. Les trois sont des adresses bien formées qui acceptent le courrier, c'est pourquoi ce sont des indicateurs et non des verdicts.
- 06
valid, le booléen strict.
Indique si l'adresse est bien formée et si son domaine peut recevoir du courrier. Il ne dit rien sur la boîte aux lettres, donc il est true pour de nombreuses adresses dont le verdict est risky. Quand vous parlez du verdict, consultez result.
Cinq résultats, quatre actions à mener.
Refusez les adresses undeliverable, proposez la correction pour un typo, mettez une adresse risky en attente pour examen, et acceptez le reste. C'est toute l'intégration, et elle tient dans le gestionnaire de soumission du formulaire qui collecte l'adresse.
const answer = await bird.lookup.email({
email: "info@example.com",
});
if (answer.result === "undeliverable") {
// reason is present on this verdict and no other.
reject(answer.reason);
} else if (answer.result === "typo") {
suggest(answer.did_you_mean);
} else if (answer.result === "risky") {
// A role or disposable address is well formed and still a poor signup.
review(answer.flags);
} else {
accept(answer.delivery_confidence);
}
Ce que ça coûte, et ce que ce n'est pas.
Une adresse par requête, et chaque verdict est facturé, undeliverable inclus, car parvenir à ce verdict est le travail effectué. Il n'y a pas de mode batch ni d'import de liste. Une nouvelle tentative avec le même Idempotency-Key rejoue le verdict déjà payé. Lookup n'est pas non plus une liste de suppression : il vous dit à quoi ressemble une adresse avant l'envoi, tandis que la suppression enregistre ce qui s'est passé après, et une configuration d'envoi saine utilise les deux.
Approfondissez dans la documentation.
Rechercher une adresse e-mail détaille la requête et chaque champ de la réponse. La vue d'ensemble de Lookup couvre les deux opérations en une page, les limites de débit documentent le groupe lookup, et l'idempotence explique le coût d'un verdict rejoué.
Questions sur les adresses e-mail, réponses incluses.
Les verdicts, les indicateurs, le score de confiance, et où la suppression s'intègre.
Que révèle une recherche d'adresse e-mail ?
Quels sont les cinq verdicts ?
Pourquoi une adresse est-elle undeliverable ?
Que faire avec un verdict typo ?
En quoi delivery_confidence diffère-t-il de result ?
Il existe aussi un champ valid. Est-ce le verdict valid ?
Que signifient les flags ?
Comment dois-je écrire l'adresse ?
Ai-je besoin de Lookup pour arrêter d'envoyer aux adresses qui ont déjà rebondi ?
Mettez-le en pratique.
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Le reste de Lookup
Une clé API, une enveloppe d'erreur. Explorez l'autre fonctionnalité.
Vérifiez une adresse avant qu'elle n'atteigne votre liste.
Un seul appel dans votre gestionnaire d'inscription suffit à éliminer les rebonds, les comptes jetables et les fautes de frappe de votre base de données.