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) використовуйте веб-хуки - сервер сам звернеться до вас, коли настане подія.
• Під час пакетних операцій додавайте між запитами невелику затримку, щоб не наближатися до ліміту.