Webhook adalah permintaan HTTP yang dikirimkan oleh sebuah layanan ke URL yang Anda daftarkan setiap kali peristiwa tertentu terjadi. Ini memungkinkan sistem Anda menerima data saat terjadi, alih-alih melakukan polling API dengan memanggilnya berulang kali untuk melihat apakah ada yang baru tersedia. Dalam alur data, itu berarti sebuah pekerjaan dapat bereaksi terhadap peristiwa segera setelah sumber melaporkannya.
Platform pembayaran Stripe, misalnya, mengirimkan peristiwa webhook ke titik akhir Anda melalui HTTPS sebagai payload JSON. Titik akhir Anda harus menerima permintaan POST dan memproses data peristiwa yang diterima.
Cara Kerja Pengiriman Webhook
Dokumentasi Stripe menunjukkan mekanisme utama:
- Pendaftaran: Anda mendaftarkan URL titik akhir. Dalam mode langsung, Stripe memerlukan URL HTTPS yang dapat diakses secara publik.
- Pengakuan cepat: Titik akhir harus segera mengembalikan kode status 2xx, sebelum logika kompleks yang dapat menyebabkan timeout.
- Pengulangan: Jika pengiriman gagal, Stripe mencoba kembali selama hingga tiga hari dengan backoff eksponensial dalam mode langsung.
- Urutan: Stripe tidak menjamin bahwa peristiwa tiba dalam urutan yang mereka buat.
Mengamankan Titik Akhir Webhook
- Verifikasi tanda tangan: Stripe menandatangani setiap peristiwa dengan HMAC menggunakan SHA-256 dan menempatkan tanda tangan dalam header
Stripe-Signature. - Blok replay: Payload yang ditandatangani menyertakan cap waktu, sehingga Anda dapat menolak peristiwa yang terlalu tua.
- Tangani duplikat: Sebuah titik akhir dapat menerima peristiwa yang sama lebih dari sekali. Catat ID peristiwa yang diproses dan lewati pengulangan.
- Daftar pengirim yang diizinkan: Stripe mengirimkan webhook dari daftar alamat IP yang dipublikasikan yang dapat Anda batasi di firewall Anda.
Penggunaan Webhook yang Umum
- Kode dan penyebaran: GitHub mengirimkan payload HTTP POST ke URL Anda untuk peristiwa repositori yang Anda langgani. Dokumennya mencantumkan penggunaan seperti memulai build CI, memperbarui pelacak masalah eksternal, menyegarkan cermin cadangan, dan menyebarkan ke server produksi.
- Pembayaran: Webhook Stripe memungkinkan Anda merespons peristiwa asinkron, seperti bank yang mengonfirmasi pembayaran, pelanggan yang membantah biaya, atau pembayaran berulang yang berhasil.
- Berlangganan hanya untuk apa yang Anda butuhkan: Stripe menyarankan untuk tidak mendengarkan peristiwa tambahan atau semua peristiwa karena dapat memberikan beban yang tidak perlu pada server Anda.