Ana içeriğe atla
Her API anahtarının Noyax tarafından belirlenen bir saniyedeki istek limiti ve bir günlük istek limiti vardır. Her iki sayaç da API anahtarı başına tutulur: aynı anahtarı kullanan tüm sunucularınız aynı limitleri paylaşır. Her istekte önce saniye limiti kontrol edilir; bu limit isteği reddederse istek günlük limite hiç sayılmaz.

Header’lar

Yetki kontrolünü geçen her yanıtta her iki limitten kalan hakkınız döner:

Limit aşılırsa

Limit dolduğunda istek işlenmez ve 429 döner:
Saniye sayacı bir sonraki saniyenin başında sıfırlanır; hemen ardından tekrar denemek, limitin altına döndüğünüzde sonuç verir. Günlük sayaç ise her gün gece yarısı (Türkiye saati) sıfırlanır; günlük 429 aldıktan sonra aynı gün yeniden denemek sonuç vermez.

Neler sayılır?

  • Token ve header doğrulamasını, yetki kontrolünü geçen tüm istekler sayılır. Buna iş kuralı hatasıyla dönen (400, 404) istekler de dahildir.
  • Geçersiz token (401), header hatası (400) ya da yetki hatası (403) ile reddedilen istekler sayılmaz.
  • Saniye limitini aştığı için reddedilen bir istek günlük limite de sayılmaz.

Öneriler

  • Liste endpoint’lerinde büyük pageSize (en fazla 50) kullanarak istek sayısını azaltın.
  • Değişmeyen verileri kendi tarafınızda önbelleğe alın.
  • Toplu işlemleri hepsini aynı anda göndermek yerine yayarak saniye limitinin altında kalın.
  • X-Daily-Remaining değerini izleyin ve azaldığında toplu işlemleri erteleyin.
  • Daha yüksek bir limite ihtiyacınız varsa Noyax destek ekibiyle görüşün. Yeni limitler, yeni token aldığınızda geçerli olur.