Appearance
Ограничения запросов (Rate Limit)
Общая информация
Ограничение запросов в API применяется для каждой пары пользователь + URL path
по количеству запросов N
во временной интервал T
.
Если лимит превышен, сервер возвращает ошибку 429 (Too Many Requests)
с ответом:
json
{ "detail": "Rate limit exceeded" }
Параметры ограничений
- Пара:
пользователь + URL path
- Максимальное количество запросов (
N
):10
- Временной интервал (
T
):60 секунд
- Запросы без авторизации:
не учитываются
Разблокировка
В случае срабатывания блокировки (Rate limit exceeded
) она будет автоматически снята только после прохождения временного интервала (T
). Повторные попытки запросов раньше, чем через T
секунд - продлевают блокировку
Рекомендации
- В случае превышения лимита запросов не отправляйте запросы в течение временного интервала
T + 1
. - Используйте механизмы контроля частоты запросов (rate limiting) на стороне клиента.
- В случае превышения лимитов по обращению к API, будет возвращен HTTP-ответ со статусом ответа
429 "Too Many Requests"
, содержащий заголовок"Retry-After"
. Данный заголовок содержит в себе число секунд, которое требуется выждать прежде, чем повторно обратиться к API.