Rate limity i kody błędów

3 min czytania · API i integracje

Rate limity zapobiegają nadużyciu API. Przy przekroczeniu otrzymasz HTTP 429 z nagłówkiem Retry-After.

Limity wg planu

Trial / Standard: 60 requestów / minutę Profi: 300 requestów / minutę Business: 1000 requestów / minutę Limit jest per-token, nie per-user (możesz mieć wiele tokenów dla różnych use cases).

Kody błędów

- 401 Unauthorized: brak lub nieprawidłowy token - 403 Forbidden: token nie ma uprawnień do danej akcji (read-only token na write endpoint) - 404 Not Found: zasób nie istnieje - 429 Too Many Requests: przekroczony rate limit, poczekaj Retry-After sekund - 5xx: server error, retry z exponential backoff

Best practices

- Cache responses dla odczytu (dane uptime nie zmieniają się co sekundę) - Używaj webhooków zamiast polling, gdzie to możliwe - Przy operacjach batch używaj delay między requestami