superpowers-rest-automation

Skill do budowania automatyzacji, które bezpiecznie łączą się z zewnętrznymi API. Obsługuje uwierzytelnianie, idempotencję, limity szybkości, webhooks i mapowanie danych. Użyj go, gdy synchronizujesz systemy, budujesz przepływy ETL lub integrujesz wiele źródeł danych. Zapobiega duplikatom, unika utraty danych i loguje każde wywołanie API dla pełnej obserwacji.

1. Zdefiniuj kontrakt automatyzacji: określ format wejściowych danych (wymagane pola, walidacja), gdzie mają trafiać wyniki, co oznacza sukces oraz jakie zadania nie będą wykonane.

2. Skonfiguruj uwierzytelnianie i zarządzanie sekretami: zidentyfikuj typ autentykacji (klucz API, OAuth2, JWT lub mTLS), nigdy nie umieszczaj sekretów w kodzie, użyj zmiennych środowiskowych lub menedżera sekretów, zaplanuj odświeżanie tokenów jeśli jest wymagane.

3. Wybierz strategię idempotencji: użyj kluczy idempotencji wspieranego przez dostawcę API, stabilnych identyfikatorów zewnętrznych do operacji upsert, lokalnego magazynu stanu mapującego źródłowe ID na docelowe, lub deterministycznych hashów do deduplikacji. Jawnie udokumentuj wybraną strategię.

4. Obsłuż paginację i synchronizację przyrostową: wykryj styl paginacji (link next, kursor, page+limit, offset+limit), upewnij się że pętle nie pominęły danych, zaimplementuj synchronizację przyrostową za pomocą znaczników czasu lub kursorów.

5. Dodaj obsługę limitów szybkości i ponowień: respektuj nagłówki Rate-Limit, zaimplementuj exponential backoff, obsłuż błędy przejściowe (5xx, timeout) z ponowieniami, unikaj cichych awarii poprzez logowanie i alertowanie.

6. Wdroż obsługę błędów i monitorowanie: obsługuj błędy częściowe bez utraty danych, loguj każde wywołanie API z kontekstem, unikaj ujawniania sekretów w logach, ustaw metryki do śledzenia każdego przebiegu automatyzacji.