Webhook Nedir?
Yayın: · Son güncelleme:
Webhook Nedir? Kısaca
Webhook, bir sistemde belirli bir olay gerçekleştiğinde, önceden verilen bir adrese otomatik olarak HTTP isteği gönderen bildirim mekanizmasıdır. Ödeme alındığında mağazanın anında haberdar olması buna örnektir.
Webhook, "bir şey olunca bana haber ver" mantığıyla çalışan otomatik bildirimdir. Siz bir adres verirsiniz, karşı sistem olay gerçekleştiğinde o adrese veri gönderir.
Webhook nedir?
Klasik API kullanımında siz sorarsınız, sistem cevap verir. Webhook'ta yön tersine döner: Sistem size yazar. Bu nedenle webhook'lara bazen "ters API" de denir.
Gönderim genellikle JSON gövdeli bir POST isteğidir. İçinde olayın türü (ör. "odeme.basarili"), zamanı ve ilgili kaydın bilgileri bulunur.
Polling ile farkı
| Yöntem | Nasıl çalışır? | Sonuç |
|---|---|---|
| Polling | Her dakika "yeni sipariş var mı?" diye sorarsınız | Gecikme ve gereksiz istek |
| Webhook | Sipariş geldiği an bildirim gelir | Anlık ve verimli |
Varsayımsal bir örnek: Günde 20 sipariş alan bir mağaza, her dakika sipariş kontrolü yaparsa günde 1.440 istek atar ve bunların çok azı yeni bilgi getirir. Webhook ile yalnızca 20 bildirim gelir.
Webhook ne demek, nasıl kurulur?
Kurulum genellikle üç adımdır. Önce bildirimleri karşılayacak bir adres hazırlanır; bu, kendi sunucunuzdaki bir uç nokta ya da Zapier, n8n gibi bir otomasyon aracının verdiği adres olabilir. Ardından hizmetin panelinde bu adres ve dinlenecek olaylar seçilir. Son olarak test bildirimi gönderilip gelen veri kontrol edilir.
Güvenlik tarafında iki kural öne çıkar. Bildirimin gerçekten o hizmetten geldiğini, isteğe eklenen imzayı doğrulayarak kontrol edin. Aynı bildirim birden fazla kez gelebileceği için işlemleri tekrar edilse de sorun çıkarmayacak biçimde tasarlayın; aynı ödemeyi iki kez kaydetmek, en sık görülen hatadır.
Sıkça Sorulan Sorular
Webhook ne demek, API'den farkı ne?
API'de siz isteği başlatır ve bilgiyi çekersiniz. Webhook'ta ise karşı sistem olay olduğunda bilgiyi size kendiliğinden iter.
Webhook bildirimi ulaşmazsa ne olur?
Çoğu hizmet başarısız bildirimleri belirli aralıklarla yeniden dener. Yine de kritik işlemler için ara sıra API ile kontrol yapmak, kaçan bildirimleri yakalamanın güvenli yoludur.