Kaynaklar

Hız Limitleri

API istekleri dakikada 5 istekle sınırlıdır. Sayaç uç nokta bazlı işler; limit aşıldığında 429 döner.

Nasıl İşler

Her API isteği bir dakikalık pencere içinde sayılır. Pencere başına en fazla 5 istek kabul edilir.

KuralDeğer
Pencere1 dakika
Pencere başına istek5
Sayaç kapsamıUç nokta bazlı
Limit aşımı yanıtı429 Too Many Requests

Her uç noktanın kendi sayacı vardır: bir uç noktada limite takılmanız diğer uç noktalara yaptığınız istekleri engellemez.

Limit Aşıldığında

429 Pencere içindeki altıncı istek 429 Too Many Requests ile reddedilir. Yanıt gövdesi standart hata biçimini kullanır; ayrıntılar için Hata Kodları sayfasına bakın. Pencere dolduğunda sayaç sıfırlanır ve istekleriniz normal şekilde işlenir.

Yanıtta bekleme süresini bildiren bir başlık dönmez; yeniden denemeyi kendi tarafınızda artan aralıklarla planlayın.

Öneriler

  • İsteklerinizi kuyruğa alın ve pencereye yayın; toplu işleri tek seferde göndermeyin.
  • 429 aldığınızda artan aralıklarla (exponential backoff) yeniden deneyin.
  • Durum değişikliklerini sürekli sorgulamak yerine Webhooks kullanın — böylece sayacınızı boşa harcamazsınız.
  • Sık okunan ve seyrek değişen verileri (restoran listesi, menü) kendi tarafınızda önbelleğe alın.

Limit Artışı

Limit artışları otomatik değildir, elle yapılır. Entegrasyonunuz daha yüksek bir hıza ihtiyaç duyuyorsa hesap temsilcinizle iletişime geçin; kullanım deseninize göre uç nokta bazında artış tanımlanır.