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