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

3 мин чтения · API и интеграции

Rate-лимиты предотвращают злоупотребление API. При превышении вы получите HTTP 429 с заголовком Retry-After.

Лимиты по плану

Trial / Standard: 60 requests / минуту Profi: 300 requests / минуту Business: 1000 requests / минуту Лимит per-token, не per-user (можно иметь несколько токенов для разных use cases).

Коды ошибок

- 401 Unauthorized: отсутствует или невалидный token - 403 Forbidden: token не имеет прав на данное действие (read-only token на write endpoint) - 404 Not Found: ресурс не существует - 429 Too Many Requests: превышен rate limit, подождите Retry-After секунд - 5xx: server error, retry с exponential backoff

Best practices

- Cache responses для чтения (uptime-данные не меняются каждую секунду) - Используйте webhooks вместо polling, где это возможно - При batch-операциях используйте delay между requests