Başlarken

İstek limitleri

Her kullanıcı, tüm anahtarlarının toplamında dakikada en fazla 120 istek yapabilir. Sayaç, saatteki her dakikanın başında sıfırlanır.

Geçerli bir anahtarla yapılan isteklerin yanıtları, kullanımınızı şu başlıklarda gösterir:

AdTürAçıklama
X-RateLimit-LimitintegerDakika başına izin verilen istek sayısı.
X-RateLimit-RemainingintegerGeçerli dakikada kalan istek sayısı.
X-RateLimit-ResetintegerSayacın sıfırlanmasına kalan saniye.
Retry-AfterintegerYalnızca 429 yanıtında: tekrar denemeden önce beklemeniz gereken saniye.

Limit aşıldığında yanıt, rate_limited koduyla birlikte 429 olur. Tekrar denemeden önce Retry-After süresi kadar bekleyin.

Geçerli bir anahtar olmadan yapılan denemeler (anahtarsız, hatalı veya geçersiz kılınmış anahtarla) her IP adresi için dakikada 30 ile sınırlıdır.

Limite takılmamak için

  • Daha az istekle daha fazla öğe almak için per_page değerini en fazla 100 olacak şekilde ayarlayın.
  • TV'lerin durumunu izlemek için dakikada bir istek yeterlidir.
  • Büyük işlerde istekleri zamana yayın ve X-RateLimit-Remaining değerini takip edin.
Yanıt başlıkları200
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42
Limite ulaşıldı429
HTTP/1.1 429 Too Many Requests
Retry-After: 18
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 18

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in 18 seconds."
  }
}