Перейти к содержанию
DEVELOPERS

10. Ограничения и заголовки

Число запросов в минуту, заголовки ответа, размеры запросов и время ожидания.

Для токена API может быть установлено допустимое число запросов в минуту, для приложения «Войти через QAIRU» — допустимое число запросов в минуту для каждого студента. В этом случае каждый ответ содержит заголовки:

  • X-RateLimit-Limit-Requests — допустимое число запросов в минуту;
  • X-RateLimit-Remaining-Requests — число запросов, оставшееся в текущем окне.

При превышении ограничения возвращается ответ 429 с кодом rate_limit_exceeded и заголовком Retry-After, содержащим число секунд до возможности повторного запроса.

10.1. Идентификатор запроса

Каждый ответ содержит заголовок X-Request-ID с идентификатором запроса. Идентификатор рекомендуется сохранять в журналах клиентского приложения и указывать при обращении в университет.

10.2. Размер запросов и время ожидания

Ограничения API
ПАРАМЕТРЗНАЧЕНИЕ
Тело запроса к модулю ALEM в формате JSONНе более 20 МБ
Тело запроса к модулю ALEM в формате multipart/form-dataНе более 100 МБ
Время ожидания ответа моделиНе более 15 минут
Окно расчёта числа запросов60 секунд, скользящее
Блокировка IP-адреса15 минут после 30 неудачных попыток авторизации в течение 10 минут

Для продолжительной генерации рекомендуется потоковая передача ответа.