delivery.throttled✓ Canlı Teslim hacmin kurulum başına cap'i (120/dk; toplu ürün/kategori event'leri 60/dk) aşınca, aşan teslimler 10 dakikaya kadar geciktirilir; tavanı aşanlar düşürülür (delivery-logs'ta dropped) ve bu bildirim gelir. Lifecycle event'leri (uninstall/billing/sağlık/redact) bu sınırlardan muaftır.
← Lifecycle Webhook'ları
Ne zaman Teslim hacmi cap üstü, bazı teslimler düşürüldü — 6 saatte bir Geliştirici Bilgi — hacmi düşür / topluyu sadeleştir Abonelik / gating Yok — bağlı (connected) her kuruluma her zaman gelir
Alan Tip Zorunlu Açıklama id string ✓ Idempotency anahtarı. Aynı id tekrar gelebilir (retry) → dedup et. type string ✓ "delivery.throttled" — event mi lifecycle mı olduğunu bununla ayırt et. version string ✓ Envelope şema versiyonu ("1"). tenantId string ✓ Hangi tenant (kurulum). İşlemini buna göre yap; cross-tenant doğrula. occurredAt number ✓ Oluşma zamanı (unix ms). data object ✓ Tipe özel gövde (aşağıda).
Alan Tip Zorunlu Açıklama cls string ✓ Cap sınıfı (hangi hacim kovası aşıldı). count number ✓ Düşürülen (dropped) teslim sayısı. eventType string – En çok düşen event tipi. hint string – İnsan-okur ipucu (hacmi azalt).
Örnek webhook gövdesi (data alanı teyitli — webhook.site)
{
"id": "evt_9f2a7c1b",
"type": "delivery.throttled",
"version": "1",
"tenantId": "tnt_123",
"occurredAt": 1780000000000,
"data": {
"cls": "bulk",
"count": 37,
"eventType": "product.updated",
"hint": "Toplu güncellemeleri sadeleştir veya hacmi düşür."
}
} Toplu yazma/güncellemeleri grupla — cap'i (120/dk, bulk 60/dk) aşma; aşan teslimler 10 dk geciktirilir, tavanı aşan düşer. Kritik akış lifecycle'a dayanıyorsa rahatla: uninstall/billing/sağlık/redact cap'ten muaftır. Düşen teslimleri Callback API ile telafi et (örn. products/list ile durumu yeniden senkronla).