Nápověda a návodyAPI a integrace › Rate limity a chybové kódy

Rate limity a chybové kódy

3 min čtení · API a integrace

Rate limity zabraňují zneužití API. Při překročení dostanete HTTP 429 s Retry-After hlavičkou.

Limity podle plánu

Trial / Standard: 60 requestů / minutu Profi: 300 requestů / minutu Business: 1000 requestů / minutu Limit je per-token, ne per-user (můžete mít více tokenů pro různé use cases).

Chybové kódy

- 401 Unauthorized: chybějící nebo neplatný token - 403 Forbidden: token nemá oprávnění na danou akci (read-only token na write endpoint) - 404 Not Found: resource neexistuje - 429 Too Many Requests: překročený rate limit, počkejte Retry-After sekund - 5xx: server error, retry s exponential backoff

Best practices

- Cache responses pro čtení (uptime data se nemění každou sekundu) - Použijte webhooky namísto polling kde je to možné - Při batch operacích použijte delay mezi requesty