Hatalar ve yeniden denemeler

Her hata sabit makine kodu, insan mesajı, isteğe bağlı alan hataları ve istek kimliği taşır.

Yapılandırılmış hata biçimi

Kararı çevrilmiş mesaja göre değil, code alanına göre verin. Mesajı kullanıcıya gösterin ve requestId değerini destek tanısında tutun.

json

{
  "code": "entitlement_limit_exceeded",
  "message": "The user band ceiling has been reached.",
  "details": { "used": 50, "ceiling": 50, "band": "C" },
  "requestId": "req_01J..."
}

Yalnız güvenli hataları yeniden deneyin

429 ve geçici 5xx yanıtlarını sınırlı üstel geri çekilme ve jitter ile yeniden deneyin. Retry-After değerine uyun. Doğrulama veya yetki hatasını değişiklik yapmadan yeniden denemeyin.

400/422: isteği düzeltin
401/403: yetkiyi yenileyin veya erişim isteyin
409: mevcut durumu çözün
429/5xx: sınırlı yeniden deneme

Ticari hatalar dönüşüm yüzeyleridir

entitlement_limit_exceeded canlı sayı, tavan, mevcut bant ve sonraki fiyatı içerir. write_blocked grace modunu açıklar. band_below_live_usage düşürme öncesi faturalama sayısından kaç kaydın çıkması gerektiğini kesin olarak belirtir.