Ditandatangani dengan HMAC-SHA256
Setiap pengiriman membawa tanda tangan yang dihitung dari body dan secret endpoint Anda, jadi penerima Anda bisa memastikan permintaan itu benar-benar dari kami sebelum memprosesnya.
Webhook keluar
Tiga puluh satu event, mulai dari kontak baru dibuat hingga janji dukungan yang terlewat atau iklan yang ditolak, dikirim ke endpoint Anda sebagai HTTP POST bertanda tangan dengan pengiriman ulang otomatis. Tersedia di paket Business. Tanpa polling berulang, tanpa cron job yang terus bertanya apakah ada yang berubah.
Terakhir diperbarui:
Daftarkan endpoint hanya ke event yang relevan, alih-alih menerima semuanya lalu memfilternya sendiri.
Siapa pun bisa mengirim body JSON lewat POST. Menandatanganinya, mengirim ulang saat gagal, dan memperlihatkan apa yang terjadi, itulah yang membuatnya layak dipakai di produksi.
Setiap pengiriman membawa tanda tangan yang dihitung dari body dan secret endpoint Anda, jadi penerima Anda bisa memastikan permintaan itu benar-benar dari kami sebelum memprosesnya.
Pengiriman yang gagal dicoba ulang dengan jeda yang makin panjang, bukan dibuang, jadi jendela deploy atau gangguan singkat di sisi Anda tidak diam-diam menghilangkan event yang penting.
Lihat apa yang dikirim, kapan, apa jawaban endpoint Anda, dan berapa lama prosesnya. Debugging integrasi tidak lagi jadi perdebatan apakah event-nya terpicu atau tidak.
Setiap endpoint berlangganan event yang dibutuhkannya saja. Layanan pemenuhan pesanan yang hanya peduli pada invoice.paid tidak perlu menerima lalu membuang setiap pembaruan kontak.
Hingga dua puluh endpoint, jadi sistem gudang, relay Slack internal, dan data warehouse masing-masing bisa mendapat aliran data sendiri dengan secret masing-masing.
Event uji memungkinkan Anda memverifikasi endpoint, pengecekan tanda tangan, dan handler Anda sebelum deal.won yang sungguhan bergantung pada ketiganya.
support.ticket.breached terpicu saat janji waktu balas terlewat, satu-satunya event yang paling ingin dimasukkan banyak tim ke kanal on-call, bukan ke dasbor yang tidak pernah dibuka siapa pun.
Kontak, tahap pipeline, pesan, langkah dan balasan penjangkauan, kesepakatan, tugas, faktur, transaksi, langganan, tiket dukungan, dan peringatan akun iklan semuanya memicu event.
Webhook memberi tahu bahwa sesuatu terjadi; REST API publik memungkinkan Anda membaca atau mengubah data yang terkait. Bersama-sama, keduanya sepenuhnya menggantikan polling.
Webhook adalah Pinlyx yang mengirim HTTP POST ke URL milik Anda tepat saat sesuatu terjadi, alih-alih kode Anda yang bertanya kepada kami setiap beberapa menit apakah ada yang berubah. Tersedia tiga puluh satu event, setiap pengiriman ditandatangani, pengiriman yang gagal dicoba ulang, dan log menunjukkan persis apa jawaban endpoint Anda.
Perbedaan praktisnya ada pada latensi dan biaya. Job polling yang berjalan setiap lima menit selalu terlambat lima menit dan sebagian besar permintaannya sia-sia. Webhook tiba dalam waktu kurang dari satu detik, dan hanya saat memang ada yang perlu disampaikan.
Setiap endpoint punya secret sendiri. Kami menghitung HMAC-SHA256 dari body permintaan dengan secret itu dan mengirimkannya sebagai header tanda tangan; penerima Anda menghitung ulang lalu membandingkannya. Permintaan tanpa tanda tangan yang cocok sebaiknya ditolak.
Bandingkan dengan metode waktu konstan, bukan dengan perbandingan string biasa, dan perlakukan secret seperti kata sandi: hanya itulah yang memisahkan endpoint Anda dari siapa pun yang berhasil menebak URL-nya.
Respons selain 2xx atau timeout menandai pengiriman sebagai gagal, lalu pengiriman dicoba ulang secara bertahap. Itu mencakup kasus-kasus biasa: deploy, restart, atau database yang terkunci sesaat.
Karena ada pengiriman ulang, handler Anda harus idempoten. Rancang agar menerima event yang sama dua kali memberi hasil yang sama dengan menerimanya sekali, biasanya dengan memakai ID event sebagai kunci. Ini berlaku untuk semua sistem webhook, dan inilah kesalahan yang paling sering muncul sebagai data ganda.
Webhook keluar adalah fitur paket Business, dengan hingga dua puluh endpoint, begitu juga REST API publik yang menjadi pasangannya. Kalau Anda tidak ingin menulis penerima sama sekali, integrasi Zapier dan n8n memakai event yang sama di paket yang sama. Harga terbaru ada di halaman harga.
Siap diluncurkan
Webhook dan REST API sudah termasuk di paket Business.