Yeni: Yapay zekâ güvenlik duvarı tüm platformu izliyor ve her olayı sade bir dille açıklıyor. Nasıl çalıştığını görün

Webhook yeniden denemeleri ve idempotency: işi iki kez yapmadan olayları almak

Gönderenlerin neden yeniden denediği, kuyruk ve teslimat kimliği üzerindeki benzersiz anahtarın yinelenen işi nasıl durdurduğu ve işleyicinin canlıya alınmadan önce nasıl test edileceği.

Yeniden denemeler ve idempotency webhook’larda birlikte ilerler. Zamanında 2xx yanıtı almayan bir gönderen aynı olayı yeniden yollar, bu yüzden alıcınız bir olayı bazen iki kez görecektir. İşleyiciyi idempotent yapın: hızlıca yanıt verin, işi kuyruğa alın ve her teslimat kimliğini kaydedin; böylece tekrar eden bir teslimat fark edilir ve atlanır.

Bir entegrasyonun alıcı tarafında, her webhook’un birden fazla gelebileceğini varsayıyorum. Tüm işi istek içinde yapan bir işleyici, er ya da geç işi iki kez yapacaktır.

Webhook gönderenler neden aynı olayı yeniden dener?

Gönderen, kaybolan bir isteği ile kaybolan bir yanıtı birbirinden ayıramadığı için yeniden dener. Sunucunuz işi yapmış ama bağlantı koptuysa ya da yanıtınız gönderenin zaman aşımından sonra geldiyse, gönderen bir hata kaydeder ve olayı yeniden yollar.

RFC 9110, HTTP anlamlarını tanımlayan standart, PUT, DELETE ve güvenli metotları idempotent olarak listeler; POST bunlar arasında değildir. Bir istemci, isteğin idempotent olduğunu bilmiyorsa ya da özgün isteğin hiç uygulanmadığını tespit edebiliyorsa, idempotent olmayan bir isteği otomatik olarak yeniden denememelidir. POST’u yeniden deneyen bir gönderen, alıcının onu idempotent hale getirmesine güvenir; her denemede aynı kalan bir teslimat kimliği de alıcının bunu yapmasını sağlar.

Webhook’lar için neden kuyruk kullanılır?

Kuyruk sayesinde işleyici milisaniyeler içinde yanıt verir ve yavaş işi sonra yapar; böylece gönderenin zaman aşımı iş mantığınızla asla yarışmaz.

  1. Gönderen çağrılarını imzalıyorsa, imzayı ham gövde üzerinden doğrulayın.
  2. Teslimat kimliğini ve ham gövdeyi, teslimat kimliği üzerinde benzersiz anahtarı olan bir tabloya ekleyin.
  3. 2xx yanıtı verin. RFC 9110, bu durum için 202 Accepted kodunu tanımlar: işlenmek üzere kabul edildi, işlem henüz tamamlanmadı.
  4. Bir worker, saklanan olayı okur, işi yapar ve satırı tamamlandı olarak işaretler.

Ekleme benzersiz anahtara çarparsa olay zaten elinizdedir; bu yüzden 2xx yanıtı verin ve başka bir şey yapmayın. Tekrar eden bir olaya hata yanıtı vermek daha fazla yeniden deneme getirir. Bu, bir MQTT veritabanı yazıcısındaki cihaz ve zaman damgası üzerindeki benzersiz anahtar ile aynı fikirdir. Veritabanı çalışmıyorsa ve ekleme başarısız olursa, gönderenin daha sonra tekrar denemesi için hata yanıtı verin.

Bir webhook uç noktası kapalıysa ne olur?

Gönderen kendi zamanlamasıyla yeniden dener ve sonra durur. Denemeler ve bekleme süreleri göndericiden göndericiye farklılık gösterir; bu yüzden bakım penceresi planlamadan önce dokümantasyonunu okuyun.

Yeniden denenen olaylar geç gelir ve sırası karışabilir; bu yüzden onları geliş sırasına göre değil, yükteki zaman damgalarına göre sıralayın. Uzun bir kesintide, webhook, WebSocket ve polling karşılaştırmasında olduğu gibi, gönderenin API’si üzerinden bir telafi okuması yapmayı sürdürün.

Hermetry, saha cihazlarını canlı panolara, kurallara ve uyarılara bağlar: IoT telemetrisi ve SCADA tek bir platformda. Its webhook‘ları her yeniden deneme ve yeniden teslimde aynı kalan bir X-Webhook-Delivery kimliği taşır; teslimatlar en az bir kez yapılır ve sırası garanti edilmez. Varsayılan olarak bir teslimat, ilk deneme dahil 3 denemeye sahiptir; yeniden denemelerden önce 60.000 ms ve 300.000 ms bekleme süreleri vardır. Art arda 10 hatadan sonra uç nokta kapatılır; bir yönetici tekrar açtığında, başarısız olanlar yeniden teslim edilebilir ya da yeniden oynatılabilir.

Worker’ı yazmadan önce, gönderenin olay dokümantasyonunda, örneğin bir webhook olay referansında, olay zamanını tutan alanın hangisi olduğuna bakın.

Bir webhook’u localhost üzerinde nasıl test edersiniz?

İnternetteki bir gönderen localhost’a ulaşamaz; bu yüzden önce kaydedilmiş yükleri yerel işleyicinize karşı yeniden oynatın, ardından herkese açık bir HTTPS adresi üzerinden bir uçtan uca kontrol yapın.

  • Bir gerçek teslimatı, başlıkları ve ham gövdesiyle kaydedin ve bir komut satırı HTTP istemcisiyle iki kez yeniden gönderin. İkinci çağrı 2xx almalı ve bir yan etki yaratmamalıdır.
  • İşleyiciniz eski zaman damgalarını reddediyorsa, yeniden oynatmaları bir test sırrıyla imzalayın ve reddedildiğini görmek için bir eski zaman damgası gönderin.

Uçtan uca kontrolü, makinenize geçici bir herkese açık HTTPS adresi veren bir tünel sağlar. Test geçtiğinde onu kapatırım.

Sık sorulan sorular

Bir webhook POST’u varsayılan olarak idempotent midir?

Hayır. RFC 9110, PUT, DELETE ve güvenli metotları idempotent olarak listeler; POST bunlar arasında değildir. Bir webhook POST’u, yalnızca alıcı onu idempotent hale getirdiğinde idempotent olur; örneğin teslimat kimliğini benzersiz bir anahtar altında saklayıp tekrarları atlayarak.

Teslimat kimliklerini ne kadar süre saklamalıyım?

En az, gönderenin olayı hâlâ yeniden deneyebildiği ya da yeniden teslim edebildiği süre kadar; gönderen bunu sunuyorsa, manuel yeniden teslim günler sonra gelebilir. Her kimlik kısa bir dizgedir, bu yüzden onları haftalarca tutarım.

Teslimat kimliği yerine yük üzerinden tekilleştirme yapabilir miyim?

Yalnızca yedek çözüm olarak. İki gerçek olay aynı yüke sahip olabilir; örneğin bir değer aynı sınırı iki kez geçebilir. Teslimat kimliği yoksa, olay türünden, kaynak kimliğinden ve olayın kendi zaman damgasından bir anahtar oluşturun.

Paylaş

Saha verilerinizi bu hafta canlı görün

Bölgenizde ilk cihazlarınızla bir deneme başlatın ya da bir demo ayarlayın ve kendi senaryonuzu getirin.