Sistemleriniz olayı gerçekleştiği anda öğrensin

Giden webhook’lar ne işe yarar

Webhook, kodunuzun bize birkaç dakikada bir "bir şey oldu mu" diye sorması yerine, bir şey olduğu anda CRM Solid’in sizin denetlediğiniz bir adrese HTTP POST yapmasıdır. Yirmi altı olay mevcuttur, her teslimat imzalıdır, başarısızlıklar yeniden denenir ve kayıt, uç noktanızın tam olarak ne yanıtladığını gösterir.

Pratikteki fark gecikme ve maliyettir. Beş dakikada bir çalışan bir yoklama görevi hem beş dakika geç kalır hem de isteklerinin çoğunu boşa harcar. Webhook ise bir saniyenin altında ve yalnızca söylenecek bir şey olduğunda gelir.

Teslimatın gerçekten bizden geldiğini doğrulamak

Her uç noktanın kendi gizli anahtarı vardır. İstek gövdesinin bu anahtarla HMAC-SHA256’sını hesaplayıp imza başlığı olarak göndeririz; alıcınız aynısını yeniden hesaplayıp karşılaştırır. İmzası uyuşmayan bir istek reddedilmelidir.

Karşılaştırmayı normal dize eşitliğiyle değil sabit zamanlı yapın ve gizli anahtara bir parola gibi davranın: uç noktanızla adresi tahmin edecek herkes arasında duran tek şey odur.

Uç noktanız kapalıyken ne oluyor

2xx dışında bir yanıt ya da zaman aşımı teslimatı başarısız olarak işaretler ve teslimat artan aralıklarla yeniden denenir. Bu, sıradan durumları kapsar: bir dağıtım, bir yeniden başlatma, anlık bir veritabanı kilidi.

Yeniden denemeler var olduğu için işleyicinizin idempotent olması gerekir. Aynı olayı iki kez almanın, bir kez almakla aynı sonucu üretmesini sağlayın; genelde olay kimliğini anahtar yaparak. Bu her webhook sisteminde geçerlidir ve mükerrer kayıt olarak en sık karşımıza çıkan hatadır.

Maliyeti ne

Giden webhook’lar aylık 99 $ olan Business özelliğidir ve yirmi uç noktaya kadar destekler. Onlarla birlikte çalışan genel REST API, Pro paketinden itibaren kullanılabilir. Hiç alıcı yazmak istemiyorsanız Zapier ve n8n entegrasyonları aynı olayları tüketir.