Rate limity i kody błędów

Limit zapytań (rate limit) chroni API przed przeciążeniem i nadużyciami. Jeśli w krótkim czasie wyślesz zbyt wiele zapytań, serwer zwróci odpowiedź HTTP 429 Too Many Requests z nagłówkiem Retry-After, który mówi, ile sekund należy odczekać.

Aktualne limity

• Limit wynosi 60 zapytań na minutę na każdy token. Obowiązuje tak samo dla wszystkich planów (Trial, Standard, Profi i Business).
• Agenci LAN mają osobny limit 120 zapytań na minutę dla każdego agenta.
• Limit jest liczony osobno dla każdego tokenu (nie dla całego użytkownika). Jeśli potrzebujesz wyższego sumarycznego pułapu, utwórz kilka tokenów do różnych zastosowań (na przykład osobno dla CI/CD i osobno dla dashboardu).

Kody błędów

• 401 Unauthorized - brakujący lub nieprawidłowy token.
• 403 Forbidden - akcja nie jest dostępna w Twoim planie (na przykład utworzenie monitora po wygaśnięciu planu lub powyżej limitu Twojego planu).
• 404 Not Found - dany zasób (monitor, incydent) nie istnieje lub nie masz do niego dostępu.
• 429 Too Many Requests - przekroczony limit zapytań. Odczekaj liczbę sekund podaną w nagłówku Retry-After.
• 5xx - błąd po stronie serwera. Spróbuj ponownie z opóźnieniem stopniowo się wydłużającym (exponential backoff - na przykład 1, 2, 4, 8 sekund).

Praktyczne zalecenia

• Odpowiedzi z endpointów odczytu trzymaj w pamięci podręcznej (cache). Dane o dostępności nie zmieniają się co sekundę, więc nie musisz pobierać ich tak często.
• Tam, gdzie to możliwe, zamiast powtarzanego odpytywania (polling) używaj webhooków - serwer sam się odezwie, gdy wystąpi zdarzenie.
• Przy operacjach wsadowych dodaj krótkie opóźnienie pomiędzy zapytaniami, aby nie zbliżyć się do limitu.