Tentang video ini

Respons dalam video ini ialah respons API sebenar, dipendekkan. Kunci API, pengesahan pukal dan pengesahan fail memerlukan akaun berbayar.

Transkrip video

1. 00:00Permintaan pertama anda

   Permintaan pertama anda ialah POST ke /verify/single. Hantar satu medan JSON, email. Letakkan kunci API anda dalam pengepala BV-API-KEY. Itulah keseluruhan permintaan. Simpan kunci itu dalam pemboleh ubah persekitaran pada pelayan anda, jangan sekali-kali dalam kod klien. Mencipta kunci memerlukan akaun berbayar, dan sebarang pembelian kredit membukanya.

2. 00:24Baca respons

   Ini respons sebenar untuk alamat sokongan. Mulakan dengan status. Ia menyatakan role, kerana support ialah nama peti mel kongsi, bukan seseorang. Skornya ialah 0.6. Itu nilai daripada peraturan tetap, bukan kebarangkalian. Jadi bercabanglah mengikut status, bukan skor. is_deliverable ialah true, jadi pelayan e-mel menerima alamat ini. is_catch_all juga true, jadi domain ini menerima sebarang alamat. Role mengambil status, dan bendera masih menunjukkan selebihnya. Reason memberi sebabnya, sebagai satu kod. Di sini ia ialah catch-all deliverable.

3. 01:02Mengapa credits_used ialah 0

   Dokumen mempunyai halaman yang menyenaraikan setiap kod. Sekarang credits_used. Ia sifar di sini, tetapi itu tidak bermakna semakan percuma. Akaun ini sudah menyemak alamat ini dalam 24 jam lalu, jadi ulangan itu tidak dicaj. Semakan pertama seperti ini menggunakan satu kredit. verification_mode memberitahu dari mana jawapan datang. Yang ini datang daripada sejarah cache. Gunakannya untuk memahami keputusan. Untuk pengebilan, baca credits_used.

4. 01:23Sehingga 50 alamat

   Ada senarai pendek? Gunakan /verify/bulk. Pengepala kekal sama, dan badan menerima tatasusunan emails, sehingga 50 alamat. Keputusan kembali dalam respons yang sama. Setiap alamat mendapat medan yang sama seperti yang anda lihat tadi. Yang pertama ialah catch-all. Yang kedua tidak sah, kerana peti mel itu tidak wujud. Yang ketiga pakai buang. Ketiga-tiganya menggunakan satu kredit. Tidak sah dikira. Yang pakai buang dikira di sini kerana permintaan ini menetapkan check_smtp kepada true. Tinggalkannya, dan padanan pakai buang berhenti awal, tanpa caj. Jadi secara lalai, tidak diketahui, sintaks buruk dan pakai buang tidak mengenakan kos. Yang lain ialah satu kredit, termasuk catch-all dan role. Di bawah keputusan, anda mendapat jumlah. valid_emails ialah sifar, kerana catch-all tidak dikira sebagai sah. Dan buckets mengumpulkan kelompok itu: satu boleh digunakan dengan catch-all, dua tidak boleh dihantar. Hantar lebih daripada 50, dan anda mendapat HTTP 400 dengan kod 3103. Senarai tidak dipecahkan untuk anda, dan ia tidak menjadi tugas fail. Ralat itu menunjukkan anda ke endpoint fail.

5. 02:28Senarai lebih besar

   Untuk senarai yang lebih besar, muat naik fail. Ia tak segerak, jadi muat naik memberi anda ID tugas. Gunakan ID itu untuk menyemak kemajuan. Apabila tugas selesai, muat turun keputusan. Kekalkan bendera -L, kerana muat turun boleh mengubah hala. Muat turun ialah CSV. Lajur asal anda kekal, dan lajur baharu menyusul, seperti ev_status dan ev_reason.

6. 02:49Semak kredit anda

   /credits memberitahu anda berapa yang tinggal. Ia GET, dengan pengepala yang sama. Semaknya sebelum muat naik besar, kerana tanpa kredit yang mencukupi, API memulangkan 402.

7. 03:00Dua pilihan permintaan

   Dua pilihan mengubah apa yang dilakukan oleh semakan. SMTP dihidupkan secara lalai, dan tiada e-mel dihantar. check_smtp false melangkau pelayan e-mel, jadi kebanyakan alamat kembali sebagai tidak diketahui. force_refresh true melangkau cache, dan anda membayar untuk keputusan baharu.

8. 03:17Ralat dan had

   Kendalikan tiga ralat dahulu. 401 ialah kunci yang hilang atau tidak sah. 402 bermaksud kredit tidak mencukupi. 429 ialah had kadar, jadi berundur dan cuba lagi. Had kadar dikenakan bagi setiap kunci API. 6,000 permintaan seminit pada single. 1,500 pada bulk.

9. 03:37Langkah seterusnya

   300 pada muat naik fail. Itulah mula pantas. Single, bulk, fail dan kredit. Rujukan API penuh, SDK dan webhook ada di billionverify.com/docs. 20 kredit percuma setiap hari anda menggunakan akaun, sehingga 600 sebulan. Tiada kad kredit diperlukan. Mulakan di billionverify.com.

Dipaparkan dalam video ini