Stuur één adres en krijg één oordeel: valid, neutral, risky, undeliverable of typo. Daarnaast een betrouwbaarheidsscore van 0 tot 100, de vlaggen die aangeven wat voor soort adres het is, en het adres waar een typefout waarschijnlijk voor bedoeld was. Eén verzoek, geen lijst om te uploaden en geen taak om te pollen.
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 []
Een oordeel waar u op kunt vertakken.
Geen percentage waarvoor u een drempel moet kiezen.
E-mailadres opzoeken is een van de twee bewerkingen in de Bird Lookup API. Het veld om uw logica tegen te schrijven is result, omdat het syntax-, domein-, mailbox- en reputatiecontroles al terugbrengt tot vijf uitkomsten. delivery_confidence is er voor gevallen waarin u wilt beoordelen in plaats van blokkeren, bijvoorbeeld een risicovolle aanmelding vasthouden voor review in plaats van weigeren. Het adres dat u stuurt is het adres dat terugkomt: het lokale deel is hoofdlettergevoelig en wordt niet naar kleine letters omgezet, en de display-name-vorm wordt afgewezen in plaats van geparsed.
Zes velden, en waar elk voor dient.
Elk ervan komt mee met hetzelfde enkele verzoek.
- 01
result, het oordeel.
valid is veilig om naar te versturen. neutral is afleverbaar zonder verdere aanbeveling. risky accepteert waarschijnlijk e-mail maar geeft reden tot aarzeling. undeliverable kan geen e-mail ontvangen. typo leest als een typefout van een echt adres.
- 02
reason, alleen waar van toepassing.
invalid_syntax, invalid_domain of invalid_recipient, die benoemt welke van de drie controles het adres niet heeft doorstaan. Het is aanwezig bij het oordeel undeliverable en bij geen ander, dus de afwezigheid ervan is ook informatie.
- 03
did_you_mean, de correctie.
Het adres waar een typo op lijkt, klaar om te tonen aan de persoon die het typte. Een aanmeldformulier dat de correctie aanbiedt, behoudt het account in plaats van het te verliezen aan een bounce die niemand ziet.
- 04
delivery_confidence, 0 tot 100.
Een beoordeling in plaats van een beslissing, en dat is wat het onderscheidt van result. Twee adressen kunnen hetzelfde oordeel delen en ver uit elkaar liggen op dit getal, en dat verschil is waar een reviewwachtrij thuishoort.
- 05
flags, het type adres.
role voor een gedeelde mailbox zoals info of support, disposable voor een wegwerpprovider, en free_provider voor een consumentenmailbox. Alle drie zijn correct gevormde adressen die e-mail accepteren, daarom zijn het vlaggen en geen oordelen.
- 06
valid, de strikte boolean.
Of het adres correct gevormd is en het domein überhaupt e-mail kan ontvangen. Het zegt niets over de mailbox, dus het is true voor veel adressen waarvan het oordeel risky is. Wanneer u het oordeel bedoelt, lees dan result.
Vijf uitkomsten, vier acties.
Weiger de onbestelbare, bied de correctie aan bij een typo, houd een risicovol adres vast voor review, en accepteer de rest. Dat is de volledige integratie, en het past in de submithandler van het formulier dat het adres verzamelt.
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);
}
Wat het kost, en wat het niet is.
Eén adres per verzoek, en elk oordeel wordt gefactureerd, inclusief undeliverable, omdat het bereiken van dat oordeel het werk is. Er is geen batchvorm en geen lijstupload. Een retry met dezelfde Idempotency-Key herhaalt het oordeel waarvoor u al heeft betaald. Lookup is ook geen suppressielijst: het vertelt u hoe een adres eruitziet voordat u verzendt, terwijl suppressie vastlegt wat er gebeurde nadat u dat deed, en een gezonde verzendopstelling gebruikt beide.
Ga dieper in de documentatie.
Een e-mailadres opzoeken doorloopt het verzoek en elk veld in het antwoord. Het Lookup-overzicht behandelt beide bewerkingen op één pagina, rate limits documenteert de lookup-groep, en idempotentie legt uit wat een herhaald oordeel kost.
Vragen over e-mailadressen, beantwoord.
De oordelen, de vlaggen, de betrouwbaarheidsscore, en waar suppressie past.
Wat vertelt een e-mailadres-lookup?
Wat zijn de vijf oordelen?
Waarom is een adres onbestelbaar?
Wat moet ik doen met een typo-oordeel?
Hoe verschilt delivery_confidence van result?
Er is ook een valid-veld. Is dat het valid-oordeel?
Wat betekenen de flags?
Hoe moet ik het adres schrijven?
Heb ik Lookup nodig om te stoppen met verzenden naar adressen die al gebounced zijn?
Breng het in de praktijk.
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.
De rest van Lookup
Eén API-sleutel, één foutenvelop. Ontdek de andere mogelijkheid.
Controleer een adres voordat het op uw lijst terechtkomt.
Eén aanroep in uw aanmeldhandler houdt de bounces, wegwerpadressen en spelfouten uit de database.