Rate limity a chybové kódy

Limit požiadaviek (rate limit) chráni API pred preťažením a zneužitím. Ak za krátky čas pošlete príliš veľa požiadaviek, server vráti odpoveď HTTP 429 Too Many Requests s hlavičkou Retry-After, ktorá hovorí, koľko sekúnd treba počkať.

Aktuálne limity

• Limit je 60 požiadaviek za minútu na každý token. Platí rovnako pre všetky plány (Trial, Štandard, Profi aj Business).
• LAN agenti majú samostatný limit 120 požiadaviek za minútu na každého agenta.
• Limit sa počíta pre každý token zvlášť (nie pre celého používateľa). Ak potrebujete vyšší celkový strop, vytvorte si viac tokenov pre rôzne použitia (napríklad samostatne pre CI/CD a samostatne pre dashboard).

Chybové kódy

• 401 Unauthorized - chýbajúci alebo neplatný token.
• 403 Forbidden - akcia nie je dostupná vo vašom pláne (napríklad vytvorenie monitora po expirácii plánu alebo nad rámec limitu vášho plánu).
• 404 Not Found - daný zdroj (monitor, incident) neexistuje alebo k nemu nemáte prístup.
• 429 Too Many Requests - prekročený limit požiadaviek. Počkajte počet sekúnd uvedený v hlavičke Retry-After.
• 5xx - chyba na strane servera. Skúste znovu s postupne sa predlžujúcim oneskorením (exponential backoff - napríklad 1, 2, 4, 8 sekúnd).

Odporúčania pre prax

• Odpovede z čítacích endpointov si ukladajte do vyrovnávacej pamäte (cache). Údaje o dostupnosti sa nemenia každú sekundu, nemusíte ich teda toľko krát ťahať.
• Tam, kde je to možné, namiesto opakovaných otázok (polling) použite webhooky - server vám sám zavolá, keď nastane udalosť.
• Pri dávkových operáciách pridajte medzi požiadavky krátke oneskorenie, aby ste sa nepriblížili k limitu.