lokalise-performance-tuning

Skill optymalizuje wydajność integracji Lokalise poprzez implementację zaawansowanych technik pracy z API. Wykorzystuje paginację kursorową dla dużych zbiorów danych (5K+ kluczy), lokalne cache'owanie zmniejszające liczbę żądań, operacje zbiorcze do 500 kluczy na request, throttling pod limit 6 req/s oraz selektywne pobieranie wybranych języków. Idealne gdy doświadczasz wolnych odpowiedzi API, wdrażasz strategie cache'owania lub optymalizujesz przepustowość żądań w projektach translacyjnych.

1. Upewnij się, że masz zainstalowany SDK @lokalise/node-api w wersji 9+ (ESM) lub dostęp do REST API Lokalise. Ustaw zmienną środowiskową LOKALISE_API_TOKEN z Twoim kluczem API.
2. Zidentyfikuj rozmiar projektu — liczbę kluczy i języków — aby prawidłowo skalibrować rozmiary partii. Dla projektów z 5K+ kluczy paginacja kursorowa będzie znacznie szybsza niż offset pagination.
3. Wdrażaj paginację kursorową w swoim kodzie, ustawiając limit na 500 kluczy na request (maksimum dozwolone) i używając parametru cursor do iteracji przez wyniki. Pozwala to uniknąć degradacji wydajności związanej z pomijaniem wierszy.
4. Implementuj lokalne cache'owanie (Redis lub biblioteka LRU) dla wyników API, aby zmniejszyć liczbę powtarzających się żądań i przyspieszić dostęp do danych translacyjnych.
5. Grupuj operacje na kluczach w partie do 500 elementów na request, respektując limit 6 żądań na sekundę. Throttling zapobiega przekroczeniu limitów API i stabilizuje przepustowość.
6. Opcjonalnie pobieraj selektywnie tylko języki, które są potrzebne w danym momencie, zamiast całego projektu, aby zmniejszyć rozmiar transferu danych.