Початок роботи

Ліміти запитів

Кожен користувач може виконувати до 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."
  }
}