lokalise-rate-limits

Skill do zarządzania limitami szybkości API Lokalise (6 żądań na sekundę). Implementuje automatyczne kolejkowanie żądań z odstępem 170ms, eksponencjalny backoff dla błędów 429, monitorowanie kwot przez nagłówki odpowiedzi i throttling operacji zbiorczych. Używaj gdy otrzymujesz błędy rate limit, chcesz zoptymalizować przepustowość API lub wdrażasz logikę ponownych prób. Kompatybilny z Claude Code, Codex i OpenClaw.

1. Zainstaluj wymaganą bibliotekę: npm install @lokalise/node-api p-queue. Upewnij się, że masz Node.js 18+ i skonfigurowany token API Lokalise (zakres read lub read/write w zależności od operacji). 2. Przeczytaj nagłówki odpowiedzi API: X-RateLimit-Limit (maksimum 6 żądań na sekundę), X-RateLimit-Remaining (pozostałe żądania w oknie), X-RateLimit-Reset (timestamp resetowania) i Retry-After (na odpowiedziach 429). Nigdy nie zakładaj stałych wartości limitów — Lokalise może je dostosować do planu. 3. Skonfiguruj kolejkę żądań z p-queue ustawiając concurrency na 1 i interval na 170ms (1000ms podzielone przez 6 żądań). Gwarantuje to minimalny odstęp między żądaniami i zapobiega przekroczeniu limitu. 4. Wdrażaj eksponencjalny backoff dla odpowiedzi 429: czekaj czas wskazany w nagłówku Retry-After, a następnie zwiększaj czas oczekiwania (np. 1s, 2s, 4s) przy kolejnych błędach. 5. Monitoruj limity proaktywnie przed każdym żądaniem, sprawdzając X-RateLimit-Remaining z poprzedniej odpowiedzi. Jeśli zbliżasz się do zera, wstrzymaj nowe żądania do resetowania okna. 6. Dla operacji zbiorczych (bulk operations) stosuj throttling — dziel duże partie na mniejsze partie i kolejkuj je z odpowiednimi opóźnieniami, aby uniknąć nagłych skoków żądań.