Webhook, bir yazılımda belirli bir olay gerçekleştiğinde (ödeme alındı, sipariş oluştu, form dolduruldu) diğer yazılıma anında ve otomatik olarak haber gönderen bildirim mekanizmasıdır; sürekli sormak yerine olay olduğunda bildirir.
Webhook, API'nin ters yönde çalışan halidir. Klasik API'de sizin yazılımınız karşı tarafa düzenli aralıklarla sorar: yeni bir şey var mı? Webhook'ta ise karşı taraf, olay gerçekleştiği anda sizin belirlediğiniz bir adrese küçük bir veri paketi gönderir. Ödeme kuruluşu ödemenin onaylandığını, kargo firması paketin teslim edildiğini, form aracı yeni bir başvuru geldiğini bu yolla iletir. Sizin yazılımınız bu bildirimi alır ve gereken işlemi başlatır: siparişi onaylar, müşteriye e-posta atar, stok düşer. Kurulum tarafında yapılan iş, karşı sisteme hangi olaylarda hangi adrese bildirim göndereceğini tanımlamaktan ibarettir.
İşletme sahibi için neden önemli
Webhook, süreçlerin gerçek zamanlı akmasını sağlar. Ödeme onayı beş dakika sonra kontrol edilen bir sistemde müşteri beklemede kalır; webhook ile onay saniyeler içinde işlenir. Ayrıca sunucu kaynağını korur: durmadan sormak yerine yalnızca gerektiğinde çalışılır. E-ticaret, ödeme, kargo ve CRM entegrasyonlarının büyük kısmı bu mekanizmaya dayanır; teklif aldığınız yazılımın webhook desteği, otomasyon kurabilme kapasitenizi doğrudan etkiler.
Örnek
Bir online eğitim platformunda öğrenci kredi kartıyla ödeme yapıyor. Ödeme kuruluşu onayı verir vermez platformun webhook adresine bildirim gönderiyor; platform aynı anda öğrencinin hesabını açıyor, hoş geldiniz e-postasını yolluyor ve muhasebeye fatura talebini düşürüyor. Kimse ödeme listesini elle kontrol etmiyor.
Sık yapılan hata
Webhook'un her zaman ulaştığını varsaymaktır. Ağ kesintisi ya da sunucu bakımı sırasında gelen bildirim kaybolabilir; iyi tasarlanmış sistemler yeniden deneme ve kayıt tutma mekanizmasıyla bunu telafi eder. İkinci hata, gelen bildirimi doğrulamamaktır: kaynağı kontrol edilmeyen bir webhook adresi, sahte ödeme onayı üretmek için kullanılabilir.
Teklif alırken sorulacak soru
Webhook bildirimleri kaybolursa nasıl yakalanacak, yeniden deneme ve kayıt mekanizması var mı? Gelen bildirimlerin gerçekten ilgili kaynaktan geldiği nasıl doğrulanacak?
Sık sorulanlar
Webhook ile API aynı şey mi?
İkisi birbirini tamamlar. API'de siz karşı tarafa sorarsınız; webhook'ta karşı taraf olay olduğunda size haber verir. Çoğu entegrasyon ikisini birlikte kullanır.
Webhook için sitemin sürekli açık olması gerekir mi?
Evet. Bildirimi alacak adres erişilebilir olmalıdır; bu yüzden barındırma kalitesi ve kesinti durumunda yeniden deneme desteği önem taşır.