İstek Limitleri

Her istemci (client) için saatte 10.000 istek limiti uygulanır. Limit, kayan pencere (sliding window) algoritmasıyla takip edilir.

Yanıt Başlıkları

Her yanıtta aşağıdaki başlıklar döner:

Başlık	Örnek	Açıklama
X-RateLimit-Limit	10000	Saat başına toplam hak
X-RateLimit-Remaining	9900	Mevcut pencerede kalan hak
X-RateLimit-Reset	1777004495	Pencerenin sıfırlanacağı Unix zaman damgası
X-Request-Id	req_b27eae60-...	Destek talepleri için korelasyon kimliği

Limit Aşımı

Limit aşıldığında 429 Too Many Requests hatası döner:

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Retry after 1820 seconds.",
    "request_id": "req_..."
  }
}

Retry-After başlığında, yeniden deneme için beklenmesi gereken süre saniye cinsinden belirtilir.

Önerilen Uygulamalar

• Üstel geri çekilme (exponential backoff) uygulayın: 1s → 2s → 4s → 8s → 16s → ...
• İstekleri kuyruk sistemi üzerinden düzenli olarak gönderin.
• Liste uç noktalarında per_page parametresini yüksek tutarak toplam sayfa sayısını azaltın.
• Statik verileri (para birimi, ülke vb.) önbelleğe (cache) alın; her istekte yeniden sormayın.