maintainx-rate-limits

Skill do integracji z API MaintainX, który implementuje inteligentne ograniczanie tempa zapytań, eksponencjalny backoff i paginację opartą na kursorach. Automatycznie obsługuje błędy 429, kolejkuje żądania do 5 równoczesnych połączeń i utrzymuje minimalny odstęp między requestami. Użyj go, gdy pracujesz z API MaintainX i chcesz uniknąć throttlingu lub zoptymalizować przepustowość bez ręcznego zarządzania retry'ami.

1. Upewnij się, że masz dostęp do API MaintainX i ustawioną zmienną środowiskową MAINTAINX_API_KEY z Twoim kluczem autoryzacyjnym. Skill wymaga Node.js 18+ oraz biblioteki axios zainstalowanej w projekcie.

2. Zainstaluj skill w swoim projekcie Claude Code lub kompatybilnym środowisku (Codex, OpenClaw). Skill będzie dostępny do wyzwolenia frazami zawierającymi "maintainx rate limit", "maintainx throttling", "maintainx 429", "maintainx retry", "maintainx backoff" lub "maintainx pagination".

3. Wyzwól skill, gdy potrzebujesz wysłać żądania do API MaintainX. Skill automatycznie opakowuje Twoje requesty w RateLimitedClient, który zarządza kolejką żądań i utrzymuje maksymalnie 5 równoczesnych połączeń.

4. Skill obsługuje błędy 429 (rate limit exceeded) poprzez eksponencjalny backoff — każde ponowne żądanie czeka coraz dłużej, aż serwer będzie gotów. Nie musisz ręcznie implementować logiki retry.

5. Dla dużych zbiorów danych użyj paginacji opartej na kursorach — skill automatycznie iteruje przez strony wyników, przekazując cursor do następnego żądania, bez konieczności ręcznego liczenia offsetów.

6. Monitoruj przepustowość: skill ogranicza tempo do 10 żądań na sekundę (minimalny odstęp 100 ms). Jeśli potrzebujesz szybszych żądań, dostosuj parametr minDelayMs w konfiguracji.