Први кораци

Ограничење захтева

Сваки корисник може да пошаље до 120 захтева у минуту, збирно за све своје кључеве. Бројач се враћа на нулу на почетку сваког минута по сату.

Одговори на захтеве са важећим кључем приказују потрошњу у овим заглављима:

НазивТипОпис
X-RateLimit-LimitintegerБрој дозвољених захтева у минуту.
X-RateLimit-RemainingintegerКолико захтева је преостало у текућем минуту.
X-RateLimit-ResetintegerБрој секунди до враћања бројача на нулу.
Retry-AfterintegerСамо у одговору 429: број секунди које треба сачекати пре новог покушаја.

Када се ограничење премаши, одговор је 429 са кодом rate_limited. Сачекајте време из Retry-After пре новог покушаја.

Покушаји без важећег кључа (без кључа, са погрешним или опозваним кључем) ограничени су на 30 покушаја у минуту по IP адреси.

Како да не достигнете ограничење

  • Користите per_page до 100 да бисте добили више ставки са мање захтева.
  • За праћење статуса ТВ уређаја довољан је један захтев у минуту.
  • Код великих задатака распоредите захтеве током времена и пратите X-RateLimit-Remaining.
Заглавља одговора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
Ограничење је достигнуто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."
  }
}