Rate limity a chybové kódy

Limit požadavků (rate limit) chrání API před přetížením a zneužitím. Pokud za krátký čas pošlete příliš mnoho požadavků, server vrátí odpověď HTTP 429 Too Many Requests s hlavičkou Retry-After, která říká, kolik sekund je třeba počkat.

Aktuální limity

• Limit je 60 požadavků za minutu na každý token. Platí stejně pro všechny plány (Trial, Standard, Profi i Business).
• LAN agenti mají samostatný limit 120 požadavků za minutu na každého agenta.
• Limit se počítá pro každý token zvlášť (ne pro celého uživatele). Pokud potřebujete vyšší celkový strop, vytvořte si více tokenů pro různá použití (například samostatně pro CI/CD a samostatně pro dashboard).

Chybové kódy

• 401 Unauthorized - chybějící nebo neplatný token.
• 403 Forbidden - akce není dostupná ve vašem tarifu (například vytvoření monitoru po vypršení tarifu nebo nad rámec limitu vašeho tarifu).
• 404 Not Found - daný zdroj (monitor, incident) neexistuje nebo k němu nemáte přístup.
• 429 Too Many Requests - překročen limit požadavků. Počkejte počet sekund uvedený v hlavičce Retry-After.
• 5xx - chyba na straně serveru. Zkuste znovu s postupně se prodlužujícím zpožděním (exponential backoff - například 1, 2, 4, 8 sekund).

Doporučení pro praxi

• Odpovědi ze čtecích endpointů si ukládejte do vyrovnávací paměti (cache). Údaje o dostupnosti se nemění každou sekundu, nemusíte je tedy tolikrát tahat.
• Tam, kde je to možné, místo opakovaných dotazů (polling) použijte webhooky - server vám sám zavolá, když nastane událost.
• Při dávkových operacích přidejte mezi požadavky krátké zpoždění, abyste se nepřiblížili k limitu.