Invia un indirizzo e ottieni un verdetto: valid, neutral, risky, undeliverable o typo. Insieme, un punteggio di affidabilità da 0 a 100, i flag che indicano il tipo di indirizzo e l'indirizzo a cui un errore di battitura sembra corrispondere. Una sola richiesta, nessuna lista da caricare e nessun job da interrogare.
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 verdetto su cui puoi ramificare la logica.
Non una percentuale per cui scegliere una soglia.
La ricerca indirizzo email è una delle due operazioni della Bird Lookup API. Il campo su cui scrivere la logica è result, perché riduce già i controlli su sintassi, dominio, casella e reputazione a cinque esiti. delivery_confidence serve per i casi in cui si vuole valutare anziché bloccare, ad esempio mettendo in revisione una registrazione rischiosa invece di rifiutarla. L'indirizzo inviato è l'indirizzo restituito: la parte locale è case-sensitive e non viene convertita in minuscolo, e il formato display-name viene rifiutato anziché analizzato.
Sei campi, e a cosa serve ciascuno.
Arrivano tutti con la stessa singola richiesta.
- 01
result, il verdetto.
valid è sicuro per l'invio. neutral è recapitabile senza particolari indicazioni. risky probabilmente accetta posta ma con un motivo di esitazione. undeliverable non può ricevere posta. typo sembra un errore di battitura di un indirizzo reale.
- 02
reason, solo dove applicabile.
invalid_syntax, invalid_domain o invalid_recipient, indicando quale dei tre controlli l'indirizzo non ha superato. È presente solo nel verdetto undeliverable, quindi anche la sua assenza è un'informazione.
- 03
did_you_mean, la correzione.
L'indirizzo a cui un typo sembra corrispondere, pronto da mostrare a chi l'ha digitato. Un modulo di registrazione che propone la correzione recupera l'account invece di perderlo in un bounce che nessuno vede.
- 04
delivery_confidence, da 0 a 100.
Un punteggio anziché una decisione, ed è questo che lo distingue da result. Due indirizzi possono condividere lo stesso verdetto ma distare molto su questo numero, e in quel divario si colloca una coda di revisione.
- 05
flags, il tipo di indirizzo.
role per una casella condivisa come info o support, disposable per un provider usa e getta e free_provider per una casella consumer. Tutti e tre sono indirizzi ben formati che accettano posta, ed è per questo che sono flag e non verdetti.
- 06
valid, il booleano ristretto.
Indica se l'indirizzo è ben formato e se il suo dominio può ricevere posta. Non dice nulla sulla casella, quindi è true per molti indirizzi il cui verdetto è risky. Quando intendete il verdetto, leggete result.
Cinque esiti, quattro azioni.
Rifiutare gli undeliverable, proporre la correzione per un typo, mettere in revisione un indirizzo risky e accettare il resto. Questa è l'intera integrazione, e sta nell'handler di invio del modulo che raccoglie l'indirizzo.
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);
}
Quanto costa e cosa non è.
Un indirizzo per richiesta, e ogni verdetto viene fatturato, incluso undeliverable, perché raggiungere quel verdetto è il lavoro. Non esiste un formato batch né un caricamento di liste. Un retry con lo stesso Idempotency-Key riproduce il verdetto già pagato. Lookup inoltre non è una suppression list: indica com'è un indirizzo prima dell'invio, mentre la suppression registra cosa è successo dopo, e un setup di invio efficiente usa entrambi.
Approfondisci nella documentazione.
Ricerca di un indirizzo email illustra la richiesta e ogni campo della risposta. La panoramica di Lookup copre entrambe le operazioni in una pagina, rate limits documenta il gruppo lookup e idempotency spiega quanto costa un verdetto riprodotto.
Domande sugli indirizzi email, con risposte.
I verdetti, i flag, il punteggio di affidabilità e dove si colloca la suppression.
A cosa risponde una verifica di indirizzo email?
Quali sono i cinque verdetti?
Perché un indirizzo risulta undeliverable?
Cosa devo fare con un verdetto typo?
In cosa differisce delivery_confidence da result?
C'è anche un campo valid. È il verdetto valid?
Cosa significano i flag?
Come devo scrivere l'indirizzo?
Ho bisogno di Lookup per smettere di inviare a indirizzi che hanno già generato un bounce?
Mettilo in pratica.
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Il resto di Lookup
Una API key, un formato di errore unico. Esplora l'altra funzionalità.
Verifica un indirizzo prima che raggiunga la tua lista.
Una singola chiamata nel tuo handler di registrazione tiene i bounce, gli account usa e getta e gli errori di battitura fuori dal database.