Rate limitek és hibakódok

A kéréskorlát (rate limit) megvédi az API-t a túlterheléstől és a visszaéléstől. Ha rövid idő alatt túl sok kérést küld, a szerver HTTP 429 Too Many Requests választ ad a Retry-After fejléccel, amely megmondja, hány másodpercet kell várni.

Aktuális korlátok

• A korlát tokenenként 60 kérés percenként. Minden csomagra egyformán érvényes (Trial, Standard, Profi és Business).
• A LAN-ügynököknek külön korlátjuk van: ügynökönként 120 kérés percenként.
• A korlát tokenenként külön számolódik (nem a teljes felhasználóra). Ha nagyobb össz-keretre van szüksége, hozzon létre több tokent különböző célokra (például egyet a CI/CD-hez és egy másikat a dashboardhoz).

Hibakódok

• 401 Unauthorized - hiányzó vagy érvénytelen token.
• 403 Forbidden - a művelet nem érhető el az Ön csomagjában (például monitor létrehozása a csomag lejárta után vagy a csomag korlátján felül).
• 404 Not Found - az adott erőforrás (monitor, incidens) nem létezik, vagy nincs hozzá hozzáférése.
• 429 Too Many Requests - túllépte a kéréskorlátot. Várjon annyi másodpercet, amennyit a Retry-After fejléc megad.
• 5xx - szerveroldali hiba. Próbálja újra fokozatosan növelt késleltetéssel (exponential backoff - például 1, 2, 4, 8 másodperc).

Gyakorlati ajánlások

• Az olvasó végpontok válaszait tárolja gyorsítótárban (cache). A rendelkezésre állási adatok nem változnak másodpercenként, így nem kell olyan gyakran lekérni őket.
• Ahol lehet, ismétlődő lekérdezés (polling) helyett használjon webhookokat - a szerver magától hívni fogja, ha esemény történik.
• Kötegelt műveleteknél tegyen rövid késleltetést a kérések közé, hogy ne kerüljön közel a korláthoz.