Rate limit'ler

Kurulum başına

Uygulamaların çağırabildiği tüm işlemler kurulum başına tek bir kovayı (bucket) paylaşır; rate limit (istek sınırı) bu kova üzerinden işler:

Ani yük (burst)	40 istek
Dolum	saniyede 2 istek
Kuyruklama	yok — sınırı aşan istekler geciktirilmez, reddedilir

Kova yalnızca size aittir: başka bir uygulama ya da aynı uygulamanın başka bir mağazadaki kurulumu onu ne etkiler ne de ondan etkilenir.

Sınır her uygulama route’unda uygulanır. Her yanıt — başarılı ya da hatalı — nerede durduğunuzu söyler:

Header	Anlamı
RateLimit-Limit	Kova boyutu: 40.
RateLimit-Remaining	Şu anda yapabileceğiniz kalan istek sayısı.
RateLimit-Reset	Kovanın yeniden dolmasına kalan saniye.

Sınırı aştığınızda rate_limited koduyla standart hata zarfını ve Retry-After alırsınız:

HTTP/1.1 429 Too Many Requests
Retry-After: 3
RateLimit-Limit: 40
RateLimit-Remaining: 0
RateLimit-Reset: 20

{"error":{"code":"rate_limited","message":"This installation exceeded its request rate. …","request_id":"…"}}

Retry-After tam saniye cinsindendir, en az 1. 429’a tepki vermek yerine RateLimit-Remaining değerini izleyin ve sıfıra ulaşmadan yavaşlayın. Toplu işler için batch route’larını tercih edin — 100 ürünlük tek bir toplu güncelleme yalnızca bir istek sayılır.

Token endpoint’i

POST /apps/token endpoint’inin kendi sınırı vardır: IP adresi başına dakikada 20 istek, sabit pencere. Sınırın üzerinde 429 alırsınız (gövdesini ayrıştırmayın). Doğru yazılmış bir uygulama onu saatte yaklaşık bir kez çağırır.