Nedir
Başarısız webhook teslimleri için ücretsiz bir triyaj masası. Düz bir kaydı okur ve onu vakalar, nedenler ve sonraki adımlardan oluşan net bir listeye çevirir.
Webhook hata triyajı
Düşen her webhook'a bir otopsi.
Stripe, GitHub, Shopify ya da kendi kuyruğundaki teslim kaydını yapıştır. Webhook Morgue her hatayı nedeniyle etiketler, hangilerinin güvenle tekrar gönderilebileceğini söyler ve makul bekleme süreleriyle bir tekrar planı çıkarır.
Kimin için
Ödeme, alışveriş ya da kod platformlarından webhook alan ve neyin tekrar deneneceğine hızla karar vermesi gereken geliştiriciler ve nöbetçi mühendisler için.
Neyi çözer
Körlemesine tekrar denemeleri. Bir 401 ya da 410'u tekrar göndermek sadece yeni hatalar üretir; 500 ya da zaman aşımı ise çoğu zaman sakin bir tekrar ister. Bu araç ikisini ayırır.
Vaka dosyası
Her satıra bir teslim. Olay, durum kodu ve notu dikey çizgiyle ayır ya da JSON satırları yapıştır.
Örnek satır: invoice.paid | 500 | upstream timeout | 14:02
Henüz vaka yok
Sekiz teslimlik tam bir otopsi görmek için demo kaydı yükle ya da kendi kaydını yapıştır.
Kayıt tarayıcında okunur. Hiçbir şey yüklenmez.
İmza kontrolü
401 hatalarının çoğu eşleşmeyen bir imzadan gelir. Ham gövdeyi, imza anahtarını ve imza başlığını yapıştır, uyuşup uyuşmadıklarını gör.
Test anahtarı kullan. Kontrol tarayıcında çalışır ve anahtar bu sayfadan hiç çıkmaz.
HMAC SHA 256, tarayıcındaki Web Crypto API ile hesaplanır.
Ölüm nedenleri
Her hatanın genelde ne anlama geldiği ve ne yapman gerektiği.
Zaman aşımı
Artan aralıklarla tekrar gönder. İşleyici birkaç saniye içinde yanıt versin, yavaş işleri kuyruğa bıraksın.
Alıcı çöktü
Alıcı düzeldiğinde artan aralıklarla tekrar gönder. Bu olay için alıcının hata kayıtlarına bak.
Hız sınırına takıldı
Alıcının istediği süre kadar bekle, sonra yavaşça tekrar gönder.
İmza ya da yetki reddedildi
Şimdilik tekrar gönderme. İki taraftaki imza anahtarını kontrol et, sonra bir kez tekrar gönder.
Uç nokta yok
Tekrar gönderme. Webhook'u yeni uç noktaya yönlendir ya da aboneliği kaldır.
İçerik reddedildi
Olduğu gibi tekrar gönderme. İşleyiciyi ya da şemayı düzelt, sonra bir kez tekrar gönder.
Yönlendirildi
Alıcılar yönlendirme yapmamalı. Webhook adresini son adresle güncelle.
Teslim edildi
Yapılacak bir şey yok. Bu teslim ulaştı.
Nasıl kullanılır
Kaydı dışa aktar
Başarısız teslimleri sağlayıcının panelinden ya da kendi kuyruğundan kopyala. Olay adı ve durum kodu yeterli.
Otopsiyi başlat
Her satır, ölüm nedeni ve net bir sonraki adımı olan etiketli bir vakaya dönüşür.
Plana uy
Güvenli vakaları önerilen takvimle tekrar gönder, diğerlerini önce düzelt, sonra raporu ekibinle paylaş.
Neler yapmaz
- Sağlayıcına bağlanmaz ve senin yerine bir şey göndermez. Neyin ne zaman tekrar gönderileceğini söyler.
- Alıcının içini göremez. 500, kodunun hata verdiği anlamına gelir; nedenini kayıt tek başına söylemez.
- Yalnızca burada gösterilen biçimleri okur. Alışılmadık kayıtların önce biraz temizlenmesi gerekebilir.
Sorular
Kaydım bir yere gönderiliyor mu?
Hayır. Ayrıştırma, plan ve imza kontrolü tamamen tarayıcında çalışır.
Neden her şeyi tekrar göndermiyoruz?
Bir 401, 404 ya da 422'yi tekrar göndermek aynı şekilde yeniden başarısız olur, alarm ya da kilitlenmeye yol açabilir. Önce nedeni düzelt, sonra bir kez gönder.
Bekleme süreleri neden eşit değil?
Jitter denen küçük bir rastgele kayma, çok sayıda denemenin toparlanan sunucuya aynı saniyede çarpmasını önler.