Kirim satu alamat dan dapatkan satu putusan: valid, netral, berisiko, tidak dapat dikirim, atau salah ketik. Di sampingnya, skor kepercayaan dari 0 hingga 100, flag yang menunjukkan jenis alamatnya, dan alamat yang kemungkinan dimaksud dari kesalahan ketik. Satu permintaan, tanpa daftar yang perlu diunggah dan tanpa tugas yang perlu di-poll.
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 []
Putusan yang bisa Anda jadikan percabangan.
Bukan persentase yang mengharuskan Anda memilih ambang batas.
Pencarian alamat email adalah salah satu dari dua operasi dalam Bird Lookup API. Kolom untuk menulis logika Anda adalah result, karena kolom ini sudah mereduksi pemeriksaan sintaks, domain, kotak surat, dan reputasi menjadi lima hasil. delivery_confidence tersedia untuk kasus di mana Anda ingin memberi nilai alih-alih memblokir, misalnya menahan pendaftaran berisiko untuk ditinjau alih-alih menolaknya. Alamat yang Anda kirim adalah alamat yang dikembalikan: bagian lokal bersifat case-sensitive dan tidak diubah ke huruf kecil, dan format display-name ditolak alih-alih diparsing.
Enam kolom, dan fungsi masing-masing.
Semuanya hadir dalam satu permintaan yang sama.
- 01
result, putusannya.
valid aman untuk dikirim. neutral dapat menerima email tanpa ada rekomendasi khusus. risky kemungkinan menerima email dan memiliki alasan untuk ragu. undeliverable tidak dapat menerima email. typo tampak seperti salah ketik dari alamat asli.
- 02
reason, hanya jika berlaku.
invalid_syntax, invalid_domain, atau invalid_recipient, menyebutkan pemeriksaan mana dari tiga pemeriksaan yang gagal pada alamat tersebut. Kolom ini ada pada putusan undeliverable dan tidak pada putusan lain, jadi ketidakhadirannya juga merupakan informasi.
- 03
did_you_mean, koreksinya.
Alamat yang tampak dimaksud dari salah ketik, siap ditampilkan kepada orang yang mengetiknya. Formulir pendaftaran yang menawarkan koreksi menyelamatkan akun alih-alih kehilangannya karena bounce yang tidak terlihat siapa pun.
- 04
delivery_confidence, 0 hingga 100.
Sebuah nilai alih-alih keputusan, itulah yang membedakannya dari result. Dua alamat bisa memiliki putusan yang sama tetapi berjauhan pada angka ini, dan jarak itulah tempat antrean peninjauan seharusnya berada.
- 05
flags, jenis alamatnya.
role untuk kotak surat bersama seperti info atau support, disposable untuk penyedia sekali pakai, dan free_provider untuk kotak surat konsumen. Ketiganya adalah alamat yang valid dan menerima email, itulah mengapa mereka berupa flag dan bukan putusan.
- 06
valid, boolean yang sempit.
Apakah alamat tersebut memiliki format yang benar dan domainnya dapat menerima email sama sekali. Ini tidak mengatakan apa pun tentang kotak surat, sehingga bernilai true untuk banyak alamat yang putusannya berisiko. Jika yang Anda maksud adalah putusan, baca result.
Lima hasil, empat tindakan.
Tolak yang tidak dapat dikirim, tawarkan koreksi untuk salah ketik, tahan alamat berisiko untuk ditinjau, dan terima sisanya. Itulah seluruh integrasinya, dan bisa masuk ke submit handler formulir yang mengumpulkan alamat.
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);
}
Berapa biayanya, dan apa yang bukan.
Satu alamat per permintaan, dan setiap putusan ditagih, termasuk undeliverable, karena mencapai putusan tersebut adalah pekerjaannya. Tidak ada bentuk batch dan tidak ada unggahan daftar. Percobaan ulang dengan Idempotency-Key yang sama memutar ulang putusan yang sudah Anda bayar. Lookup juga bukan daftar supresi: ia memberi tahu Anda seperti apa suatu alamat sebelum Anda mengirim, sementara supresi mencatat apa yang terjadi setelah Anda mengirim, dan pengaturan pengiriman yang sehat menggunakan keduanya.
Pelajari lebih dalam di dokumentasi.
Cari alamat email memandu permintaan dan setiap kolom dalam respons. Ikhtisar Lookup mencakup kedua operasi dalam satu halaman, batas rate mendokumentasikan grup lookup, dan idempotensi menjelaskan biaya putusan yang diulang.
Pertanyaan alamat email, terjawab.
Putusan, flag, skor kepercayaan, dan posisi supresi di dalamnya.
Apa yang dijawab oleh pencarian alamat email?
Apa saja lima putusan tersebut?
Mengapa sebuah alamat berstatus undeliverable?
Apa yang harus saya lakukan dengan putusan typo?
Apa perbedaan delivery_confidence dengan result?
Ada juga field valid. Apakah itu putusan valid?
Apa arti flag-flag tersebut?
Bagaimana cara menulis alamat tersebut?
Apakah saya perlu Lookup untuk berhenti mengirim ke alamat yang sudah bounce?
Put it into practice.
Continue with the documentation, guides and examples for this topic. Resources are in English.
Lookup lainnya
Satu API key, satu format error. Jelajahi kemampuan lainnya.
Periksa alamat sebelum masuk ke daftar Anda.
Satu panggilan di handler pendaftaran Anda mencegah bounce, akun sekali pakai, dan kesalahan ketik masuk ke database.