Webhook
Webhook, bir sistemde bir olay olduğunda başka bir sisteme otomatik olarak haber gönderilmesidir. Karşı sistem sürekli sormak zorunda kalmaz, olay olunca haberi kendisi alır.
Webhook nedir?
Webhook, bir yazılımın bir olay olduğunda önceden verilen bir adrese kendiliğinden mesaj göndermesidir. API'de siz sorarsınız, karşı taraf cevap verir. Webhook'ta karşı taraf, olay olur olmaz size haber verir. Bu yüzden bazen ters API diye de anlatılır.
Bir örnek verelim. Müşteriniz sitenizde kartla ödeme yaptı. Ödeme kuruluşu ödemenin onaylandığını sitenize bir webhook ile bildirir. Siteniz bu mesajı alınca siparişi onaylar ve depoya bildirim gönderir. Siteniz her dakika "ödeme geldi mi" diye sormak zorunda kalmaz. Aynı yöntem kargo durumu değiştiğinde ya da fatura kesildiğinde de kullanılır.
Neden önemli?
Webhook, sistemler arasındaki bilgiyi bekletmeden taşır ve gereksiz sorguları azaltır. Doğru kurulmazsa mesaj kaybolabilir. Bu yüzden gelen mesajın gerçekten doğru kaynaktan geldiği kontrol edilmeli ve işlenemeyen mesajlar yeniden denenmelidir. Bağlantıları nasıl kurduğumuzu entegrasyon sayfasında anlattık. Ödeme onayının webhook ile nasıl geldiğini sanal POS entegrasyonu yazısında anlattık.
Sık sorulanlar
Webhook ile API arasındaki fark nedir?
API'de siz sorarsınız, karşı taraf cevap verir. Webhook'ta karşı taraf, olay olur olmaz size kendiliğinden haber verir. Çoğu entegrasyonda ikisi birlikte kullanılır.
Webhook güvenli mi?
Doğru kurulursa evet. Gelen mesajın imzası kontrol edilerek gerçekten beklenen kaynaktan geldiği doğrulanır. Adres https olmalı ve mesaj işlenmeden önce içeriği kontrol edilmelidir.
Webhook mesajı ulaşmazsa ne olur?
Çoğu hizmet başarısız mesajı belli aralıklarla yeniden gönderir. Yine de mesajların kaydını tutmak ve aynı mesajın iki kez işlenmesini engellemek gerekir. Böylece bir sipariş iki kez onaylanmaz.