Tentang video ini

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

Transkrip video

1. 00:00Unggah file

   Unggah CSV ke /verify/file, lalu biarkan webhook memberi tahu saat selesai. Bulk berhenti di 50 alamat. Untuk yang lebih besar, kirim seluruh file sebagai multipart form data. CSV, TXT, dan XLSX diterima. email_column menyebut kolom yang dibaca. Jika dihilangkan, kolomnya terdeteksi otomatis. Ini file ujinya. Empat baris, ditambah kolom source yang ingin kita simpan di hasil. Unggahan tidak menunggu pemeriksaan. Unggahan menjawab dengan ID tugas dan status pending. Unggahan juga memberi tahu kolom mana yang dibaca, serta berapa baris dan alamat unik yang ditemukan. Seperti kunci API itu sendiri, pekerjaan file untuk akun berbayar.

2. 00:43Lacak pekerjaan

   Untuk memeriksanya, lakukan GET ke path yang sama dengan ID tugas ditambahkan. Header sama, tanpa body. Saat ditanyakan segera, file kecil ini sudah dalam tahap merging. Selama berjalan, status melewati tahap seperti preparing, pending, processing, dan merging. Berhenti bertanya setelah Anda melihat completed, completed with warning, failed, atau cancelled. Inilah pekerjaan yang selesai. Hitungannya membagi file menurut status: satu tidak valid, satu role, satu catch-all, dan satu sekali pakai. credits_used adalah satu, dan cache_hit_not_charged adalah tiga. Tiga baris adalah pemeriksaan ulang. Alamat itu sudah diperiksa di akun ini dalam 24 jam terakhir, dan pemeriksaan ulang dalam 24 jam tidak ditagih. Ada dua tautan. download_url adalah path API yang stabil, jadi itulah yang disimpan. direct_download_url adalah tautan penyimpanan bertanda tangan, dan berhenti berfungsi pada waktu kedaluwarsa yang tertera.

3. 01:35Ambil hasilnya

   Panggil results dan simpan keluarannya ke file. Tanpa filter, API mengalihkan ke file hasil lengkap, dan dash L mengikuti pengalihan itu. Kolom Anda datang lebih dulu, tanpa perubahan. Lalu kolom ev_ menyusul, seperti status, score, dan reason, di setiap baris. Hanya butuh baris yang harus dihapus? Tambahkan filter. Filter digabung dengan OR, jadi ini meminta tidak valid atau sekali pakai. Dengan filter, CSV dibuat dan dikirim langsung. Dua baris kembali, yaitu yang harus dihapus.

4. 02:04Pakai webhook

   Polling bisa berjalan, tetapi pekerjaan panjang berarti banyak permintaan. Webhook membaliknya. BillionVerify memanggil server Anda saat pekerjaan file selesai atau gagal. Daftarkan satu dengan POST ke /webhooks. Berikan URL HTTPS dan event yang Anda inginkan. Ada dua: file.completed dan file.failed. Respons itu membawa secret penandatanganan, dan itu satu-satunya saat Anda melihatnya. Simpan segera. Anda memerlukannya untuk memeriksa setiap pengiriman. Setiap pengiriman adalah POST JSON dengan tiga header: event, timestamp, dan tanda tangan. Body menyebut event dan waktunya. Isi data-nya membawa ID pekerjaan, hitungan, kredit yang dipakai, dan tautan unduhan.

5. 02:44Periksa tanda tangan

   Periksa tanda tangan sebelum bertindak atas sebuah pengiriman. Gabungkan header timestamp, sebuah titik, dan body mentah. Jalankan HMAC-SHA256 atasnya dengan secret Anda, lalu bandingkan dengan header tanda tangan. Hash body persis seperti saat diterima. JSON yang di-parse lalu di-encode ulang tidak akan cocok. Dan tolak timestamp yang kedaluwarsa, agar permintaan lama tidak bisa diputar ulang. Jadi seluruh alurnya singkat. Unggah, simpan ID tugas, tunggu webhook, lalu ambil hasilnya dari tautan yang stabil.

6. 03:11Langkah berikutnya

   Nilai status, filter, dan setiap field webhook ada di referensi API, di billionverify.com/docs/api-reference. 20 kredit gratis setiap hari Anda memakai akun, hingga 600 per bulan. Tanpa kartu kredit. Mulai di billionverify.com.