Restomenum Geliştirici
Giriş yapKayıt ol

Teslim Sağlığı & Politikası ✓ Canlı

Webhook teslim garantileri: retry, circuit breaker (sürekli başarısız endpoint'i koruma), 72 saat kalıcı durdurma ve hacim cap'i. Endpoint sağlığın doğrudan teslim akışını (ve senkron hook'larda tenant deneyimini) etkiler. Sağlık bildirimleri delivery.* lifecycle webhook'larıyla gelir.

Retry

Her teslim 20 deneme, exponential backoff (10 sn → 3600 sn) — toplam ≈11,4 saatlik pencere, üstüne 24 saatlik sert tavan. Son deneme de başarısızsa teslim dead olur (delivery-logs'ta görünür).

⏳ Pencere 31 saniyeden ~11,4 saate çıkarıldı (şu an yalnız sandbox; production kuyruğu hâlâ eski ayarda). Kuyruk 6 deneme · 1 sn başlangıç backoff'u ile çalışıyordu: 1+2+4+8+16 = 31 saniye — tüketicinin bir deploy'u, bir restart'ı ya da kısa bir kesintisi olayı kalıcı olarak düşürüyordu. Karşılaştırma: Shopify 8 deneme / 4 saat · Square 11 / 24 saat · Stripe 3 gün.
Idempotency artık daha kritik. Aynı olay 20 kez tekrar teslim edilebilir ve iki teslim arasında saatler geçebilir → zarftaki id alanı ile dedup zorunlu. 31 saniyelik pencere bu ihtiyacı pratikte gizliyordu; artık gizlemiyor. (Webhook alıcısı'ndaki dedup deseni.)

Circuit breaker

Endpoint'in sürekli başarısızsa teslimler geçici atlanır (boşa retry yığmamak için):

  • Açılma: 10 ardışık dead teslim VEYA 15 dakikalık pencerede ≥20 denemede ≥%90 fail.
  • Açıkken: teslimler denenmez — delivery-logs'ta skipped (skipReason: 'open'|'half-open').
  • Cooldown: 5 dk'dan başlar, her açılışta ikiye katlanır (tavan 1 saat). Cooldown sonunda tek bir probe teslimi denenir.
  • Sıfırlanma: herhangi bir başarılı teslim breaker'ı tamamen sıfırlar.
  • Breaker açıldığında delivery.degraded, kapandığında delivery.restored gönderilir.

72 saat kuralı — kalıcı durdurma

Breaker kesintisiz 72 saat açık kalırsa webhook teslimi KALICI durdurulur(delivery.disabled).
  • Callback API erişimin sürer — düzeltme yaparken veri çekmeye devam edebilirsin; yalnız push teslimi durur.
  • Geri açmak: portaldan "yeniden etkinleştir" VEYA başarılı bir test event (breaker'ı otomatik sıfırlar + kalıcı disable'ı kaldırır).

Hacim cap'i (throttle)

  • Sınır: kurulum başına 120 teslim/dk (toplu ürün/kategori event'leri için 60/dk).
  • Aşımda: teslimler hemen düşürülmez — 10 dakikaya kadar geciktirilir; tavanı aşanlar düşer (delivery-logs'ta dropped, capClass/capCount) ve delivery.throttled gönderilir.
  • Muafiyet: lifecycle event'leri (uninstall / billing / sağlık / redact) bu sınırlardan muaftır.

Senkron gate / action'lar

Breaker açıkken endpoint'ine hiç gidilmez — hook'un kendi failMode kararı anında uygulanır (open → allow, closed → deny). Restoran personeli bekletilmez. failMode:closed kullanıyorsan endpoint sağlığın doğrudan tenant deneyimidir.

Manuel yeniden gönderme (redeliver)

Geliştirici, portaldaki teslim loglarından başarısız bir teslimi elle yeniden gönderebilir (GitHub "Redeliver" paritesi). Teslim, install'ın güncel webhookUrl + secret'iyle yeni bir deliveryId altında normal retry hattına girer.

idempotencyKey (envelope id) AYNI kalır → senin dedup'ın çift işlemeyi önler. Yani redeliver'da aynı id'yi tekrar görürsen güvenle yut. Manuel redeliver breaker/cap'ten bağımsızdır; başarılı bir redeliver breaker'ı doğal bir probe gibi kapatabilir.

Özet — sağlık sinyalleri

Durumdelivery-logsWebhook
Breaker açıldıskippeddelivery.degraded
Normale döndü—delivery.restored
72h → kalıcı durduskippeddelivery.disabled
Cap aşıldıdroppeddelivery.throttled