Limity zapytań

Zakres limitu

Dla zapytań uwierzytelnionych limit liczony jest per użytkownik i organizacja (czyli osobno dla każdej pary konto + organizacja wskazana nagłówkiem X-Organization-Id). Dla zapytań bez uwierzytelnienia (np. publiczny formularz kontaktowy) limit liczony jest per adres IP klienta.

Domyślne okna limitu

Standardowy limit dla zapytań uwierzytelnionych to okno stałe ok. 300 zapytań na 60 sekund — licznik zeruje się na granicy każdego okna, a nie w sposób kroczący (dokładna wartość może się różnić w zależności od konfiguracji środowiska). Część endpointów ma dodatkowe, bardziej restrykcyjne limity — dotyczy to m.in. operacji kosztownych obliczeniowo (np. asystent AI, generowanie raportów, optymalizacja tras) oraz publicznych endpointów bez uwierzytelnienia (formularz kontaktowy, webhooki integracji telematycznych).

Odpowiedź po przekroczeniu limitu

Po przekroczeniu limitu API zwraca status 429 Too Many Requests. Odpowiedź może zawierać nagłówek Retry-After z liczbą sekund, po których warto ponowić zapytanie.

Zalecenia

• Odczytuj i respektuj nagłówek Retry-After, jeśli jest obecny.
• Stosuj wykładniczy backoff z jitterem przy automatycznych ponowieniach.
• Unikaj współdzielenia jednego konta/nagłówka organizacji przez wiele niezależnych procesów integracyjnych — każda para użytkownik + organizacja ma własny licznik.