Tentang video ini

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

Transkrip video

1. 00:00Muat naik fail

   Muat naik CSV ke /verify/file, kemudian biarkan webhook memberitahu anda apabila ia selesai. Bulk terhenti pada 50 alamat. Untuk apa-apa yang lebih besar, hantar keseluruhan fail sebagai data borang multipart. CSV, TXT dan XLSX diterima. email_column menamakan lajur yang perlu dibaca. Tinggalkannya, dan ia dikesan untuk anda. Ini fail ujian. Empat baris, serta lajur source yang kami mahu kekalkan dalam keputusan. Muat naik tidak menunggu semakan. Ia menjawab dengan ID tugas dan status pending. Ia juga memberitahu anda lajur mana yang dibaca, dan berapa banyak baris serta alamat unik yang ditemuinya. Seperti kunci API itu sendiri, tugas fail ialah untuk akaun berbayar.

2. 00:43Jejaki tugas

   Untuk menyemaknya, GET laluan yang sama dengan ID tugas ditambah. Pengepala yang sama, tiada badan. Apabila ditanya serta-merta, fail kecil ini sudah pun bergabung. Semasa ia berjalan, status bergerak melalui langkah seperti preparing, pending, processing dan merging. Berhenti bertanya apabila anda melihat completed, completed with warning, failed atau cancelled. Inilah tugas yang selesai. Kiraan membahagikan fail mengikut status: satu tidak sah, satu role, satu catch-all dan satu pakai buang. credits_used ialah satu, dan cache_hit_not_charged ialah tiga. Tiga baris ialah semakan semula. Alamat itu telah disemak pada akaun ini dalam 24 jam lalu, dan semakan semula dalam 24 jam tidak dicaj. Dua pautan disertakan. download_url ialah laluan API yang stabil, jadi itulah yang perlu disimpan. direct_download_url ialah pautan storan bertandatangan, dan ia berhenti berfungsi pada masa tamat tempoh yang ditunjukkan.

3. 01:35Dapatkan keputusan

   Panggil results dan simpan output ke fail. Tanpa penapis, API mengubah hala ke fail keputusan penuh, dan bendera -L mengikuti ubah hala itu. Lajur anda datang dahulu, tidak berubah. Kemudian lajur ev_ menyusul, seperti status, score dan reason, pada setiap baris. Hanya perlukan baris yang hendak dikeluarkan? Tambah penapis. Ia digabungkan dengan OR, jadi ini meminta tidak sah atau pakai buang. Dengan penapis, CSV dibina dan dihantar semula secara langsung. Dua baris kembali, iaitu yang perlu dikeluarkan.

4. 02:04Gunakan webhook

   Polling berfungsi, tetapi tugas yang panjang bermakna banyak permintaan. Webhook membalikkannya. BillionVerify memanggil pelayan anda apabila tugas fail selesai atau gagal. Daftarkan satu dengan POST ke /webhooks. Beri ia URL HTTPS dan acara yang anda mahu. Ada dua: file.completed dan file.failed. Respons itu membawa rahsia penandatanganan, dan itu sahaja masa anda akan melihatnya. Simpan dengan segera. Anda memerlukannya untuk menyemak setiap penghantaran. Setiap penghantaran ialah POST JSON dengan tiga pengepala: acara, cap masa dan tandatangan. Badan menamakan acara dan masa. Datanya membawa ID tugas, kiraan, kredit yang digunakan dan pautan muat turun.

5. 02:44Semak tandatangan

   Semak tandatangan sebelum anda bertindak pada sesuatu penghantaran. Gabungkan pengepala cap masa, satu titik dan badan mentah. Jalankan HMAC-SHA256 padanya dengan rahsia anda, dan bandingkan dengan pengepala tandatangan. Hash badan tepat seperti yang diterima. JSON yang dihuraikan dan dikodkan semula tidak akan sepadan. Dan tolak cap masa yang lapuk, supaya permintaan lama tidak boleh dimainkan semula. Jadi keseluruhan alirannya pendek. Muat naik, simpan ID tugas, tunggu webhook, kemudian ambil keputusan daripada pautan yang stabil.

6. 03:11Langkah seterusnya

   Nilai status, penapis dan setiap medan webhook ada dalam rujukan API, di billionverify.com/docs/api-reference. 20 kredit percuma setiap hari anda menggunakan akaun, sehingga 600 sebulan. Tiada kad kredit diperlukan. Mulakan di billionverify.com.