Webhook Nedir?

İngilizce: Webhook

Webhook, belirli bir olay olduğunda bir sistemin başka bir sisteme otomatik HTTP isteği göndermesini sağlayan bildirim yöntemidir.

Webhook Nedir?

Webhook, bir sistemde olay gerçekleştiğinde başka bir sisteme otomatik HTTP isteği gönderilmesidir. Örneğin ödeme sağlayıcısı “ödeme tamamlandı” olayını e-ticaret yazılımına bildirir; e-ticaret yazılımı da siparişi hazırlanıyor durumuna alabilir.

Bu yapı polling’den farklıdır. Polling’de alıcı sistem sürekli “yeni bir şey var mı?” diye sorar. Webhook’ta kaynak sistem olay olduğunda veriyi kendisi gönderir. Bu nedenle gerçek zamanlıya yakın entegrasyonlarda daha verimli bir yöntemdir.

Webhook Akışı

  1. Kaynak sistemde olay oluşur.
  2. Olay verisi JSON gibi bir payload’a dönüştürülür.
  3. Önceden tanımlı endpoint’e HTTP isteği gönderilir.
  4. Alıcı sistem imzayı doğrular, olayı işler ve uygun status kodu döner.
  5. Başarısız durumda kaynak sistem yeniden deneme yapabilir.

Güvenlik ve Dayanıklılık

Webhook endpoint’i dış dünyaya açık olduğu için imza doğrulama, HTTPS, IP kısıtı, idempotency key ve tekrar deneme stratejisi önemlidir. Aynı olay iki kez gelebilir; alıcı sistem bunu güvenli biçimde tolere etmelidir. İşlenemeyen olaylar için dead-letter queue veya hata panosu gerekir.

Webhook’lar API yerine geçmez; API veri istemek için, webhook olay bildirmek için kullanılır. İş süreçlerini tetikleyen entegrasyonlarda otomasyon ve API entegrasyonu ile birlikte tasarlanır.

Barlas Dijital’de webhook senaryoları ödeme, kargo, CRM ve bildirim akışlarında webhook ve olay tabanlı entegrasyon kapsamında ele alınır.