Първи стъпки

Лимит на заявките

Всеки потребител може да прави до 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."
  }
}