Servis Limitleri

Hız sınırları, istek gövdesi tavanları ve sayfalama sınırları.

Hız sınırı

Doğrulanmış istekler için servis grubu ve anahtar başına 10 saniyede 50 istek. Sayım uç başına değil grup başınadır; sınır iki dikeyde aynıdır. Sipariş ve mağaza uçları katalogdan ayrı gruptadır, bu yüzden büyük bir katalog yüklemesi sipariş kabulünü engellemez.

Gruplar ve uçları

Alan	Tip	Açıklama
`siparis`	grup	Sipariş okuma ve yazma, fatura, kurye, talepler, değerlendirme yanıtı, toplama ve dönüş, test siparişi. GET /orders · GET /orders/{id} · POST /orders/{id}/status · PUT /orders/{id}/invoice · PUT /orders/{id}/courier · GET /disputes · POST /disputes/{id}/respond · POST /reviews/{id}/reply · POST /orders/test · POST /orders/{id}/picking · POST /orders/{id}/return
`magaza`	grup	İşletme bilgisi, durum, çalışma saatleri ve webhook ayarı. GET /merchant · PUT /merchant/status · PUT /merchant/working-hours · GET /webhook · PUT /webhook · DELETE /webhook · POST /webhook/test
`durum`	grup	Bağlantı bildirimi. POST /reachability
`konum`	grup	Kuryenin son konumu. PUT /orders/{id}/courier/location
`katalog-okuma`	grup	Menü, kategori ağacı, ürün listesi, toplu iş sonucu, iptal sebepleri ve değerlendirmeler. GET /cancel-reasons · GET /reviews · GET /menu · GET /categories · GET /products · GET /batches/{id}
`katalog-yazma`	grup	Menü fiyat ve durumu; ürün ekleme, fiyat ve stok, satış durumu. PUT /menu/items/price · PUT /menu/items/status · PUT /menu/categories/status · POST /products · PUT /products/price-and-stock · PUT /products/status

Her işlemin grubu OpenAPI belgesinde x-service-group alanında da yazar. Test siparişi ucunun (POST /orders/test) ayrıca saatte 20 isteklik kotası vardır; aşımda 429 ve reason: test_order_quota döner.

Kalan bütçe, kimlik doğrulamasına ulaşan her yanıtın başlıklarında gelir (304 ve hata yanıtları dahil). 429 alınca Retry-After kadar bekleyin ve istekleri yayın.

Yanıt başlıkları

RateLimit-Limit: 50
RateLimit-Remaining: 37
RateLimit-Reset: 6
Retry-After: 6          # yalnız 429'da

Kimlik hatası sınırı

Hatalı kimlik denemeleri ayrı bir kovada sayılır: IP adresi başına 60 saniyede 20. Aşımda 429 too_many_requests ve reason: auth_failures döner. Bu yanıtlarda ve kimlik doğrulamasında reddedilen 401 unauthorized yanıtında RateLimit-Limit değeri 20'dir.

Alan	Tip	Açıklama
`403 integrator_header_required`	başlıksız	Kimlik doğrulamasından önce reddedilir; yanıtta yalnız `X-Request-Id` ve `X-Api-Environment` başlıkları gelir.
`400 invalid_operator`	başlıksız	Aynı biçimde, kimlik doğrulamasından önce reddedilir.
`401 environment_mismatch`	başlıksız	Aynı biçimde, kimlik doğrulamasından önce reddedilir.
`401 (anahtar değişti)`	RateLimit-Limit: 50	Yazım sırasında anahtarın değiştiği anlaşılırsa dönen 401 grup başlıklarını taşır ve değer 50'dir.
`500`	başlıksız	Kimlik aşamasında beklenmeyen bir hata oluşursa yanıtta `RateLimit-*` başlıkları bulunmaz.

İstek gövdesi tavanları

Alan	Tip	Açıklama
`Tüm gövdeler`	1 MB	Aşımda `413 payload_too_large`.
`PUT /webhook`	16 KB	Aşımda `413 payload_too_large`.
`PUT /menu/items/price · /menu/items/status · /menu/categories/status`	100	Tek istekte en fazla 100 kalem; fazlası `400 too_many_items`.
`POST /products · PUT /products/price-and-stock · PUT /products/status`	1000	Çarşı'da tek istekte en fazla 1000 kalem; fazlası `400 too_many`, boş liste `400 empty`.
`POST /orders/{id}/picking · items`	200	Tek istekte en çok 200 kalem sonucu.
`POST /disputes/{id}/respond · items`	200	Kalem bazında yanıtta en fazla 200 kalem.
`POST /orders/{id}/picking · receiptUrl`	8 MB	Fiş görseli; daha büyük ya da görsel olmayan dosya kaydedilmez ve yanıtta `receipt_not_saved` uyarısı gelir.

Sayfalama sınırları

Alan	Tip	Açıklama
`GET /orders`	limit ≤ 50	Varsayılan 50.
`GET /reviews`	limit ≤ 50	Varsayılan 20.
`GET /products`	limit ≤ 500	Varsayılan 100.

Liste uçları { items, nextCursor } döner; sayfalama yalnız imleçle yapılır. GET /disputes, GET /categories ve GET /cancel-reasons sayfasızdır, nextCursor her zaman null döner.

Sınırı daraltmak kırıcı değişiklik sayılmaz: istemci kodu değişmez, yalnız 429 sıklığı artar. Genişletmeler değişiklik kaydında duyurulur.