Webhook

Klasik entegrasyonda istemci belirli aralıklarla “yeni bir şey var mı” diye sorar; buna sorgulama denir. Webhook bunu tersine çevirir: olay gerçekleştiğinde sunucu istemciye haber verir.

Fark hem gecikme hem maliyet tarafındadır. Sorgulama yaklaşımında olay ile fark edilmesi arasında aralık kadar gecikme olur ve çoğu istek boş döner. Webhook’ta bildirim anlıktır ve gereksiz istek yoktur.

Karşılığında webhook, alıcı tarafta erişilebilir bir uç nokta gerektirir. Bu, ağ izolasyonu olan kurulumlarda uygulanabilirliği sınırlar.

Webhook’un en sık gözden kaçan yönü teslim garantisidir. Alıcı geçici olarak erişilemezse bildirim kaybolabilir; bu yüzden gönderen tarafın yeniden deneme yapması ve alıcının aynı bildirimi iki kez alabileceğini varsayması gerekir.

Bu, alıcı tarafta idempotans gerektirir: aynı olay iki kez işlendiğinde sonuç değişmemelidir. Aksi halde tekrarlanan bildirim çift kayıt veya çift işlem üretir.

Sıralama garantisi de genelde yoktur. Olaylar gönderildikleri sırayla ulaşmayabilir; alıcı, olayın kendi zaman damgasına bakarak eski bir bildirimin yeniyi ezmesini engellemelidir.

Webhook uç noktası internete açık olduğu için doğrulama gerektirir. Gönderenin kimliği bir imza veya paylaşılan gizli anahtar ile doğrulanmalıdır; aksi halde herkes sahte bildirim gönderebilir.

İkinci önlem, uç noktanın yalnızca bildirim kabul etmesi ve iş mantığını doğrudan tetiklememesidir. Bildirim kuyruğa alınıp asenkron işlenirse, hem yavaş işlemler zaman aşımına yol açmaz hem saldırı yüzeyi daralır.

Üçüncüsü, bildirim içeriğine körü körüne güvenmemektir. Gelen veriyi doğrudan kullanmak yerine, kaynak sistemden doğrulamak daha güvenli bir kalıptır.

Webhook kurulumlarının en sinsi arızası sessiz kayıptır: bildirim gelmez ve hiçbir hata görünmez. Sistem çalışıyor gibi durur ama veri güncellenmez ve sorun ancak tutarsızlık fark edildiğinde ortaya çıkar.

Bu yüzden yalnızca webhook mekanizmasına güvenmek riskli bir kalıptır. Yaygın çözüm, düşük sıklıkta bir mutabakat işi çalıştırmaktır: günde bir kez kaynak sistemle karşılaştırma yapıp kaçan olayları yakalamak. Bu, hız avantajını korurken sessiz kaybı fark edilebilir hale getirir.

Mutabakat işinin kendisi karmaşık olmak zorunda değildir: kayıt sayılarını karşılaştıran basit bir kontrol, sessiz kaybın büyük çoğunluğunu yakalar ve kurulumu birkaç saat sürer.