Tentang video ini

Respons dalam video ini adalah respons API yang nyata, dipersingkat. Kunci API, verifikasi massal, dan verifikasi file memerlukan akun berbayar.

Transkrip video

1. 00:00Request pertama Anda

   Request pertama Anda adalah POST ke /verify/single. Kirim satu field JSON, email. Taruh API key Anda di header BV-API-KEY. Hanya itu requestnya. Simpan key itu di variabel lingkungan di server Anda, jangan pernah di kode sisi klien. Membuat key memerlukan akun berbayar, dan pembelian kredit apa pun membukanya.

2. 00:24Baca responsnya

   Ini respons nyata untuk sebuah alamat dukungan. Mulai dari status. Isinya role, karena support adalah nama kotak surat bersama, bukan orang. Skornya nol koma enam. Itu nilai dari aturan tetap, bukan probabilitas. Jadi bercabanglah menurut status, bukan menurut skor. Is deliverable bernilai true, jadi server email menerima alamat ini. Is catch-all juga true, jadi domain ini menerima alamat apa pun. Role mengambil status, dan flag tetap menampilkan sisanya. Reason memberi alasannya, sebagai satu kode. Di sini, catch-all deliverable.

3. 01:02Mengapa credits_used 0

   Dokumentasi punya halaman yang mencantumkan setiap kode. Sekarang credits used. Di sini nol, tetapi itu tidak berarti pemeriksaan gratis. Akun ini sudah memeriksa alamat ini dalam 24 jam terakhir, jadi pengulangannya tidak ditagih. Pemeriksaan pertama seperti ini dikenai satu kredit. Verification mode menunjukkan dari mana jawabannya berasal. Yang ini berasal dari riwayat yang di-cache. Pakai untuk memahami hasilnya. Untuk penagihan, baca credits used.

4. 01:23Hingga 50 alamat

   Punya daftar pendek? Pakai /verify/bulk. Headernya tetap sama, dan body menerima array emails, hingga 50 alamat. Hasilnya kembali dalam respons yang sama ini. Setiap alamat mendapat field yang sama seperti yang baru Anda lihat. Yang pertama catch-all. Yang kedua tidak valid, karena kotak surat itu tidak ada. Yang ketiga sekali pakai. Ketiganya memakai satu kredit. Tidak valid juga dihitung. Yang sekali pakai dihitung di sini karena request ini menyetel check_smtp ke true. Hilangkan itu, dan kecocokan sekali pakai berhenti lebih awal, tanpa biaya. Jadi secara bawaan, tidak diketahui, sintaks buruk, dan sekali pakai tidak dikenai biaya. Semua yang lain satu kredit, termasuk catch-all dan role. Di bawah hasil, Anda mendapat total. Valid emails nol, karena catch-all tidak dihitung sebagai valid. Dan bucket mengelompokkan batch: satu dapat dipakai dengan catch-all, dua tidak dapat dikirimi. Kirim lebih dari 50, dan Anda mendapat HTTP 400 dengan kode 3103. Daftar tidak dipecah untuk Anda, dan tidak menjadi job file. Error itu mengarahkan Anda ke endpoint file.

5. 02:28Daftar yang lebih besar

   Untuk daftar yang lebih besar, unggah file. Ini asinkron, jadi unggahan memberi Anda job ID. Pakai ID itu untuk memeriksa progres. Saat job selesai, unduh hasilnya. Pertahankan flag dash L, karena unduhan bisa dialihkan. Unduhannya berupa CSV. Kolom asli Anda tetap ada, dan kolom baru menyusul, seperti ev_status dan ev_reason.

6. 02:49Cek kredit Anda

   /credits memberi tahu sisa Anda. Ini GET, dengan header yang sama. Periksa sebelum unggahan besar, karena tanpa kredit yang cukup, API mengembalikan 402.

7. 03:00Dua opsi request

   Dua opsi mengubah apa yang dilakukan sebuah pemeriksaan. SMTP aktif secara bawaan, dan tidak pernah ada email yang dikirim. check_smtp false melewati server email, sehingga kebanyakan alamat kembali tidak diketahui. force_refresh true melewati cache, dan Anda membayar hasil yang baru.

8. 03:17Error dan batas

   Tangani tiga error lebih dulu. 401 adalah key yang hilang atau tidak valid. 402 berarti kredit tidak cukup. 429 adalah rate limit, jadi mundur dan coba lagi. Rate limit berlaku per API key. 6.000 request per menit untuk single. 1.500 untuk bulk.

9. 03:37Langkah berikutnya

   300 untuk unggahan file. Itulah quickstart-nya. Single, bulk, file, dan credits. Referensi API lengkap, SDK, dan webhook ada di billionverify.com/docs. 20 kredit gratis setiap hari Anda memakai akun, hingga 600 per bulan. Tanpa kartu kredit. Mulai di billionverify.com.

Ditampilkan dalam video ini