apollo-rate-limits

Skill do zarządzania ograniczeniami szybkości w Apollo.io. Implementuje automatyczne opóźnienia i ponawianie żądań na podstawie odpowiedzi HTTP 429 oraz nagłówków rate-limit. Obsługuje wszystkie endpointy Apollo — od wyszukiwania kontaktów, przez wzbogacanie danych, aż po zarządzanie kampaniami. Czyta limity z nagłówków odpowiedzi (x-rate-limit-remaining, retry-after) i dostosowuje tempo zapytań. Wymaga Node.js 18+ i ważnego klucza API Apollo.

1. Upewnij się, że masz zainstalowany Node.js 18 lub nowszy oraz ważny klucz API Apollo.io. Skill wykorzystuje narzędzia Read, Grep i Bash (curl) do komunikacji z API.

2. Zapoznaj się ze strukturą limitów Apollo — każdy endpoint ma inny limit na minutę (np. wyszukiwanie osób: 100 req/min) i burst na sekundę (10 req/sec). Limity są zwracane w nagłówkach odpowiedzi: x-rate-limit-limit, x-rate-limit-remaining i retry-after (tylko przy 429).

3. Wyzwól skill frazami takimi jak "apollo rate limit", "apollo 429", "apollo throttling", "apollo backoff" lub "apollo request limits" w kontekście pracy z API Apollo.

4. Skill automatycznie odczyta nagłówki odpowiedzi i obliczy czas oczekiwania na podstawie pozostałych żądań (x-rate-limit-remaining) i czasu wskazanego w retry-after. Implementuje backoff — jeśli otrzymasz 429, skill czeka wskazaną liczbę sekund przed ponowieniem.

5. Dla operacji zbiorczych (bulk_match) pamiętaj o niższych limitach (10 req/min, 2 req/sec) — skill dostosuje tempo automatycznie na podstawie kategorii endpointu.

6. Monitoruj logi z nagłówkami rate-limit, aby zweryfikować, że skill prawidłowo interpretuje pozostałe żądania i stosuje opóźnienia. W przypadku błędów 429 skill czeka i ponawia — nie musisz ręcznie zarządzać retry logic.