Rate limits і коди помилок

3 хв читання · API та інтеграції

Rate limits запобігають зловживанню API. При перевищенні отримаєте HTTP 429 з заголовком Retry-After.

Ліміти відповідно до тарифу

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

Коди помилок

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

Найкращі практики

- Кешуйте responses для читання (uptime дані не змінюються щосекунди) - Використовуйте webhooks замість polling, де це можливо - При batch операціях використовуйте delay між requests