DEVekspertiz.app

03 · Rate Limit

Default kapsam

PlanDefault limitAşıldığında
Standart partner60 req/dk (per API key)429 rate_limited + Retry-After: <sn>

Limit per-key uygulanır; aynı partner birden fazla key kullanıyorsa her key kendi kuyruğunda sayar. Yüksek hacimli senaryolar için yöneticiyle iletişime geçin.

Response header'ları

Her başarılı yanıtta:

X-RateLimit-Limit:     60
X-RateLimit-Remaining: 42

429 yanıtında:

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Reset: 1715900500

Retry-After saniye cinsinden bekleme süresi. X-RateLimit-Reset sayacın sıfırlanacağı UNIX saniye.

Best practice

  1. Backoff retry. 429 alırsanız Retry-After'ı uygulayın; sabit kısa interval'larla retry etmeyin.
  2. İdempotency. GET endpoint'leri idempotent — retry güvenlidir.
  3. Bulk yerine cursor. Bir org'un tüm raporlarını çekerken ?limit=100 + cursor kullanın, paralel 100 istek atmayın.
  4. Önbellek. report_number ve id immutable — tekrar tekrar aynı raporu çekmek yerine kendi tarafınızda cache'leyin.

Sonraki: 04 · Pagination.