E-Mail-Adressprüfung
Ein Feld, um eine Adresse zu bewerten.
Senden Sie eine Adresse und erhalten Sie ein Ergebnis: valid, neutral, risky, undeliverable oder typo. Dazu einen Konfidenzwert von 0 bis 100, die Flags, die angeben, um welche Art von Adresse es sich handelt, und die Adresse, die ein Tippfehler vermutlich sein sollte. Eine Anfrage, keine Liste zum Hochladen und kein Job zum Abfragen.
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 []
Beispiel-Lookup
Vor dem Senden prüfen.
Täglich vertraut von Teams, die erstklassige Software entwickeln
Weitere Kundenberichte lesenEin Ergebnis, auf dem Sie verzweigen können.
Kein Prozentwert, für den Sie einen Schwellenwert wählen müssen.
Die E-Mail-Adressprüfung ist eine der beiden Operationen in der Bird Lookup API. Das Feld, gegen das Sie Ihre Logik schreiben, ist result, weil es Syntax-, Domain-, Postfach- und Reputationsprüfungen bereits auf fünf Ergebnisse reduziert. delivery_confidence ist für die Fälle gedacht, in denen Sie bewerten statt blockieren möchten – zum Beispiel eine riskante Anmeldung zur Prüfung zurückhalten, statt sie abzulehnen. Die Adresse, die Sie senden, ist die Adresse, die zurückkommt: Der lokale Teil unterscheidet Groß- und Kleinschreibung und wird nicht in Kleinbuchstaben umgewandelt, und die Display-Name-Form wird abgelehnt statt geparst.
Sechs Felder und wofür jedes steht.
Jedes einzelne davon kommt mit derselben einzelnen Anfrage.
- 01
result, das Ergebnis.
valid ist sicher zum Senden. neutral ist zustellbar, ohne etwas Besonderes. risky wird wahrscheinlich E-Mails annehmen, bringt aber einen Grund zum Zögern mit. undeliverable kann keine E-Mails empfangen. typo sieht nach einem Tippfehler einer echten Adresse aus.
- 02
reason, nur wo es zutrifft.
invalid_syntax, invalid_domain oder invalid_recipient – benennt, an welcher der drei Prüfungen die Adresse gescheitert ist. Es ist nur beim Ergebnis undeliverable vorhanden und bei keinem anderen, daher ist auch sein Fehlen eine Information.
- 03
did_you_mean, die Korrektur.
Die Adresse, der ein Tippfehler ähnelt – bereit, der Person vorgelegt zu werden, die sie eingetippt hat. Ein Anmeldeformular, das die Korrektur anbietet, rettet das Konto, statt es durch einen Bounce zu verlieren, den niemand sieht.
- 04
delivery_confidence, 0 bis 100.
Eine Bewertung statt einer Entscheidung – das unterscheidet es von result. Zwei Adressen können dasselbe Ergebnis teilen und bei diesem Wert weit auseinanderliegen, und in dieser Lücke gehört eine Prüfwarteschlange hin.
- 05
flags, die Art der Adresse.
role für ein gemeinsames Postfach wie info oder support, disposable für einen Wegwerf-Anbieter und free_provider für ein Consumer-Postfach. Alle drei sind korrekt formatierte Adressen, die E-Mails annehmen – deshalb sind sie Flags und keine Ergebnisse.
- 06
valid, der enge Boolean.
Ob die Adresse korrekt formatiert ist und ihre Domain überhaupt E-Mails empfangen kann. Er sagt nichts über das Postfach aus, daher ist er für viele Adressen true, deren Ergebnis risky ist. Wenn Sie das Ergebnis meinen, lesen Sie result.
Fünf Ergebnisse, vier Maßnahmen.
Lehnen Sie die undeliverable-Adressen ab, bieten Sie bei einem typo die Korrektur an, halten Sie eine riskante Adresse zur Prüfung zurück und akzeptieren Sie den Rest. Das ist die gesamte Integration, und sie passt in den Submit-Handler des Formulars, das die Adresse erfasst.
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);
}
Was es kostet und was es nicht ist.
Eine Adresse pro Anfrage, und jedes Ergebnis wird berechnet, undeliverable eingeschlossen, weil das Ermitteln dieses Ergebnisses die Arbeit ist. Es gibt keine Batch-Form und keinen Listenupload. Ein erneuter Versuch mit demselben Idempotency-Key gibt das Ergebnis zurück, für das Sie bereits bezahlt haben. Lookup ist auch keine Unterdrückungsliste: Es sagt Ihnen, wie eine Adresse aussieht, bevor Sie senden, während die Unterdrückung festhält, was danach passiert ist – und ein guter Versandprozess nutzt beides.
Mehr Details in der Dokumentation.
E-Mail-Adresse nachschlagen erläutert die Anfrage und jedes Feld der Antwort. Die Lookup-Übersicht behandelt beide Operationen auf einer Seite, Begrenzung der Anfragerate dokumentiert die Lookup-Gruppe, und Idempotenz erklärt, was ein wiederholtes Ergebnis kostet.
Fragen zur E-Mail-Adresse, beantwortet.
Die Ergebnisse, die Flags, der Konfidenzwert und wo die Unterdrückung hingehört.
Was beantwortet eine E-Mail-Adressen-Abfrage?
Welche fünf Urteile gibt es?
Warum ist eine Adresse undeliverable?
Was sollte ich bei einem typo-Urteil tun?
Wie unterscheidet sich delivery_confidence von result?
Es gibt auch ein valid-Feld. Ist das dasselbe wie das valid-Urteil?
Was bedeuten die Flags?
Wie sollte ich die Adresse schreiben?
Brauche ich Lookup, um den Versand an bereits gebouncte Adressen zu stoppen?
In die Praxis umsetzen.
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Der Rest von Lookup
Ein API-Schlüssel, eine Fehlerantwort. Entdecken Sie die andere Funktion.
Prüfen Sie eine Adresse, bevor sie in Ihrer Liste landet.
Ein einziger Aufruf in Ihrem Registrierungs-Handler hält Bounces, Wegwerf-Konten und Tippfehler aus der Datenbank.