Atur webhook
Webhook memungkinkan VerifyPDF memanggil URL-mu sendiri saat hasil verifikasi siap, jadi sistemmu diberi tahu alih-alih polling. Setel URL webhook https per kunci API.
Webhook adalah cara VerifyPDF memberi tahu sistemmu bahwa sebuah hasil sudah siap, alih-alih sistemmu bertanya berulang kali. Artikel ini menjelaskan idenya dan cara mengaktifkannya.
Apa itu webhook, dalam istilah sederhana
Saat kamu memverifikasi dokumen, hasilnya tidak selalu siap seketika. Tanpa webhook, sistemmu harus terus memeriksa, “apakah sudah selesai?” Itu disebut polling.
Webhook membalik itu. Kamu memberi VerifyPDF sebuah URL di sistemmu sendiri. Saat hasil siap, VerifyPDF memanggil URL itu dan mengirim hasilnya kepadamu. Sistemmu bereaksi terhadap panggilan itu alih-alih polling untuk perubahan.
Setel URL webhook per kunci
Setiap kunci API bisa punya URL webhook-nya sendiri. Kamu menyetelnya di dasbor:
- Masuk di secure.verifypdf.com dan buka Developers di bilah sisi kiri.
- Pilih kunci API yang ingin kamu pakai dan edit URL webhook-nya.
- Simpan. URL harus diawali https://.
Karena URL disetel per kunci, kamu bisa mengarahkan notifikasi dari integrasi berbeda ke endpoint berbeda, misalnya kunci test yang diarahkan ke URL test dan kunci live ke URL produksimu. Lihat Kunci API test vs live.
Untuk mematikan webhook bagi sebuah kunci, biarkan kolom URL kosong dan simpan.
Apa yang dikirim VerifyPDF
Saat verifikasi selesai, VerifyPDF memanggil URL webhook-mu agar sistemmu bisa menindaklanjuti hasilnya, misalnya memperbarui kasus atau memberi tahu peninjau. Untuk payload persis dan cara memastikan bahwa panggilan benar-benar berasal dari VerifyPDF, lihat referensi API di /agents/ dan dokumentasi Developers di dalam dasbor.
Langkah berikutnya
- Butuh kunci dulu? Lihat Buat dan kelola kunci API.
- Ingin alur pengiriman lengkap? Lihat Verifikasi dokumen dengan API.