İstek limitleri

Limitler işlem hacmini kısıtlamak için değil, hatalı çalışan bir entegrasyonu erken aşamada tespit etmek için tanımlanmıştır. Tek bir POS firması binlerce restorana hizmet verebilir. Olağan trafiğiniz bir sınıra dayanıyorsa tarafımıza bildirin; limit hesabınıza özel olarak yükseltilir.

Limitler

Uç nokta	Olağan	Ani yoğunluk	Uygulama düzeyi
POST /orders	600 / dakika	120 / 10 saniye	hesap
GET /orders/{id}	10 saniyede 1	3.000 / dakika	sipariş ve hesap
POST /orders/{id}/cancel	600 / dakika	—	hesap
PUT /stores/{id}	60 / dakika	200 / 10 saniye	hesap
POST /token	60 / saat	—	hesap

İki limit ayrıca açıklanmayı gerektirir.

GET /orders/{id} sipariş bazında sınırlıdır. Hesabınızda kalan hak, tek bir teslimatın arka arkaya sorgulanmasına imkân vermez. Durum bilgisi bildirimlerle takip edilmelidir.

POST /token saatte 60 istekle sınırlıdır ve token zaten bir saat geçerlidir. Bu sınıra yaklaşıyorsanız token saklanmıyor, her istekte yenisi alınıyor demektir. Bkz. Kimlik doğrulama.

Yanıt başlıkları

Her yanıtta, kullanılan hakkın durumu bildirilir:

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 588
X-RateLimit-Reset: 1785312000

X-RateLimit-Reset bir Unix zaman damgasıdır.

Limitin aşılması

HTTP/1.1 429 Too Many Requests
Retry-After: 7

{
  "success": false,
  "message": "İstek limitini aştınız.",
  "data": { "errorCode": "RATE_LIMITED", "retryAfterSeconds": 7 }
}

Retry-After başlığında belirtilen süre kadar bekleyin. Beklemeden ve arka arkaya yeniden denemeyin; süreklilik gösteren limit aşımı, erişimin kısıtlanma nedenlerinden biridir.

Test ortamı

Test ortamının hakkı ayrı tutulur, ancak limit değerleri aynıdır. Test ortamındaki denemeler canlı hakkınızı tüketmez; buna karşılık gerçek davranışı canlıya çıkmadan gözlemleme imkânı sağlar. 429 yanıtının test ortamında görülmesi, yoğun bir zaman diliminde canlıda görülmesine tercih edilir.

Limit yükseltme talebi

Talebinizi sayısal verilerle iletin: restoran sayısı, saatlik sipariş adedi ve yoğun saat aralıkları. Limitler hesap bazında yapılandırılır; değiştirilmesi için yeni bir API sürümü gerekmez.