gamma-rate-limits

Skill do obsługi limitów szybkości API Gamma. Pomaga zrozumieć progi żądań dla każdego planu (Free, Pro, Team, Enterprise), monitorować pozostałe zapytania poprzez nagłówki HTTP oraz implementować strategie ponownych prób z eksponencjalnym opóźnieniem. Idealny dla deweloperów integrujących Gamma API, którzy chcą uniknąć throttlingu i zautomatyzować obsługę błędów 429.

1. Upewnij się, że masz aktywną integrację Gamma API oraz podstawową wiedzę o nagłówkach HTTP i systemach kolejkowania żądań.

2. Po każdym zapytaniu do API Gamma sprawdź nagłówki odpowiedzi: x-ratelimit-limit (maksymalny limit), x-ratelimit-remaining (pozostałe zapytania) i x-ratelimit-reset (czas resetowania limitu w sekundach od epoki Unix). Skonwertuj czas resetowania mnożąc przez 1000, aby uzyskać wartość w milisekundach.

3. Zaimplementuj funkcję eksponencjalnego backoff do automatycznego ponowienia zapytań. Funkcja powinna próbować żądanie maksymalnie 5 razy, a między próbami czekać coraz dłużej (bazowa opóźnienie 1 sekunda, podwajane z każdą próbą).

4. Kiedy API zwróci błąd 429 (Too Many Requests), sprawdź nagłówek retryAfter w odpowiedzi błędu. Jeśli jest dostępny, czekaj tę ilość sekund (pomnożoną przez 1000 na milisekundy); w przeciwnym razie użyj obliczonego opóźnienia eksponencjalnego.

5. Monitoruj swój plan (Free: 10 żądań/min, Pro: 60/min, Team: 200/min, Enterprise: custom) i dostosuj częstotliwość zapytań do limitu. Dla planów z ograniczeniami na eksporty (Free: 10/godzinę, Pro: 100/godzinę, Team: 500/godzinę) rozłóż operacje w czasie.

6. Wyzwól skill frazami takimi jak "gamma rate limit", "gamma quota", "gamma 429", "gamma throttle" lub "gamma request limits", gdy napotkasz problemy z przepustowością lub chcesz zoptymalizować użycie API.