Rate limits и коды ошибок

Лимит запросов (rate limit) защищает API от перегрузки и злоупотреблений. Если вы отправите слишком много запросов за короткое время, сервер вернёт ответ HTTP 429 Too Many Requests с заголовком Retry-After, который сообщает, сколько секунд нужно подождать.

Действующие лимиты

• Лимит составляет 60 запросов в минуту на каждый токен. Он одинаков для всех тарифов (Trial, Стандарт, Профи и Business).
• LAN-агенты имеют отдельный лимит 120 запросов в минуту на каждого агента.
• Лимит считается для каждого токена отдельно (а не для пользователя в целом). Если вам нужен более высокий общий предел, создайте несколько токенов для разных задач (например, отдельно для CI/CD и отдельно для панели управления).

Коды ошибок

• 401 Unauthorized - отсутствующий или недействительный токен.
• 403 Forbidden - действие недоступно в вашем тарифе (например, создание монитора после окончания тарифа или сверх лимита вашего тарифа).
• 404 Not Found - данный ресурс (монитор, инцидент) не существует или у вас нет к нему доступа.
• 429 Too Many Requests - превышен лимит запросов. Подождите количество секунд, указанное в заголовке Retry-After.
• 5xx - ошибка на стороне сервера. Повторите запрос с постепенно увеличивающейся задержкой (exponential backoff - например, 1, 2, 4, 8 секунд).

Рекомендации для практики

• Сохраняйте ответы от эндпоинтов чтения в кэш. Данные о доступности не меняются каждую секунду, поэтому их не нужно запрашивать так часто.
• Там, где это возможно, вместо повторяющихся опросов (polling) используйте веб-хуки - сервер сам обратится к вам, когда наступит событие.
• При пакетных операциях добавляйте между запросами небольшую задержку, чтобы не приближаться к лимиту.