Pomoc a návodyAPI a integrácie › Rate limity a chybové kódy

Rate limity a chybové kódy

3 min čítania · API a integrácie

Rate limity zabraňujú zneužitiu API. Pri prekročení dostanete HTTP 429 s Retry-After hlavičkou.

Limity podľa plánu

Trial / Štandard: 60 requestov / minútu Profi: 300 requestov / minútu Business: 1000 requestov / minútu Limit je per-token, nie per-user (môžete mať viac tokenov pre rôzne use cases).

Chybové kódy

- 401 Unauthorized: chýbajúci alebo neplatný token - 403 Forbidden: token nemá oprávnenie na danú akciu (read-only token na write endpoint) - 404 Not Found: resource neexistuje - 429 Too Many Requests: prekročený rate limit, počkajte Retry-After sekúnd - 5xx: server error, retry s exponential backoff

Best practices

- Cache responses pre čítanie (uptime dáta sa nemenia každú sekundu) - Použite webhooky namiesto polling kde je to možné - Pri batch operáciách použite delay medzi requestmi