Limitler ve Boyutlar

Platformun kararlı kalması için API'nin istek hızına ve iletilen veri boyutuna ilişkin kısıtlamaları vardır.

İstek Hızı

İzin verilen istek hızı aşıldığında sunucu 429 Too Many Requests koduyla yanıt verir. Doğru yaklaşım, üstel geri çekilmeyle (backoff) yeniden denemektir: yeniden denemeler arasındaki beklemeyi artırın ve yoğun bir akışla istek göndermeyin. Toplu işlemleri zaman içine yayın ve tek bir tokeni paralel patlamalar yerine ardışık olarak kullanın.

İstek Gövde Boyutu

Standart REST istekleri için JSON gövde boyutu 2 MiB ile sınırlıdır. Bu, tepki yapılandırmaları, koleksiyonlar ve ayarlar için yeterlidir. Gövde daha büyükse işlemi parçalara bölün (örn. tepkileri gruplar hâlinde içe aktarın).

İçe Aktarma Gövde Boyutu

İçe aktarma uç noktaları büyük paketler için tasarlanmıştır ve ayrı, daha yüksek limitlere sahiptir: veri içe aktarma için 64 MiB'a, gömülü medyalı içe aktarma için 256 MiB'a kadar. Paket daha büyükse birden fazla içe aktarmaya bölün.

Limit Aşımı

  • Hız limiti aşıldı — 429, gecikmeli yeniden deneme.
  • Gövde izin verilen boyutu aştı — istek reddedilir (uç noktaya bağlı olarak 413 veya 400); yükü küçültün veya bölün.

Sonraki Adımlar