Лимиты
Лимит защищает кабинет компании от зациклившегося скрипта. Обычной интеграции его хватает с большим запасом.
Что | Сколько |
|---|---|
Запросов к /api/v1 | 600 в минуту на ключ или подключение OAuth |
Запросов с неверным ключом | 60 в минуту с одного IP-адреса |
Запросов к /api/oauth/token и /revoke | 120 в минуту с одного IP-адреса |
Тело запроса | До 256 КБ |
Текст сообщения или обращения | До 20 000 знаков |
Страница списка | До 100 строк |
Подписок на события | До 25 на компанию |
Как узнать остаток
В каждом ответе: X-RateLimit-Limit — лимит в минуту, X-RateLimit-Remaining — сколько запросов осталось в текущей минуте.
Что будет при превышении
Ответ 429
HTTP/1.1 429 Too Many Requests
Retry-After: 17
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 0{
"error": {
"code": "rate_limited",
"message": "Лимит — 600 запросов в минуту на ключ. Повторите через 17 с.",
"request_id": "req_3f9c2a7d1e6b4a8c0d2e5f71"
}
}Подождите столько секунд, сколько в Retry-After, и повторите. Раньше повторять бессмысленно: до конца паузы все запросы ключа получают тот же ответ 429.
Опрашивать список раз в минуту не нужно — подпишитесь на события, Дескус сам пришлёт новый тикет или сообщение.