juicebox-rate-limits

Skill do zarządzania rate limitingiem dla integracji Juicebox. Automatycznie parsuje nagłówki limitów z każdej odpowiedzi API, implementuje token bucket limiter respektujący limity serwera, obsługuje exponential backoff z jitterem dla odzyskania po błędzie 429, zarządza kolejką priorytetową dla operacji bulk sourcing i śledzi kwoty w czasie rzeczywistym dla endpointów search i enrichment. Wymaga skonfigurowanych danych dostępu do Juicebox oraz Node.js 18+.

1. Upewnij się, że masz zainstalowane zmienne środowiskowe JUICEBOX_USERNAME i JUICEBOX_API_TOKEN. Skill wymaga Node.js 18 lub nowszej wersji oraz dostępu do narzędzia curl do inspekcji nagłówków limitów.

2. Wyzwól skill frazami zawierającymi "juicebox rate limit", "juicebox quota", "juicebox throttling" lub "juicebox backoff". Skill automatycznie aktywuje się w kontekście obsługi limitów API.

3. Skill parsuje trzy nagłówki rate limit z każdej odpowiedzi API: X-RateLimit-Limit (maksimum zapytań w oknie), X-RateLimit-Remaining (pozostałe zapytania) i X-RateLimit-Reset (czas resetowania okna). Utrzymuje bieżący widok dostępnej kwoty.

4. Implementuje token bucket limiter, który respektuje limity raportowane przez serwer Juicebox. Limity różnią się w zależności od planu subskrypcji, dlatego skill dostosowuje się do rzeczywistych ograniczeń Twojego konta.

5. Obsługuje exponential backoff z jitterem dla automatycznego odzyskiwania po błędzie 429 (Too Many Requests). Nagłówek Retry-After jest parsowany i respektowany, aby uniknąć kolejnych błędów.

6. Zarządza kolejką priorytetową dla operacji bulk sourcing, umożliwiając efektywne przetwarzanie dużych ilości danych bez przekraczania limitów. Śledzi kwoty w czasie rzeczywistym dla endpointów search i enrichment oddzielnie.