Начало работы

Лимиты запросов

Каждый пользователь может выполнять до 120 запросов в минуту суммарно по всем своим ключам. Счётчик обнуляется в начале каждой минуты по часам.

В ответах на запросы с действительным ключом расход лимита показан в этих заголовках:

Имя	Тип	Описание
`X-RateLimit-Limit`	`integer`	Сколько запросов разрешено в минуту.
`X-RateLimit-Remaining`	`integer`	Сколько запросов осталось в текущей минуте.
`X-RateLimit-Reset`	`integer`	Сколько секунд осталось до обнуления счётчика.
`Retry-After`	`integer`	Только в ответе `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."
  }
}