api-patterns

Umiejętność wyboru właściwego stylu API dla Twojego projektu. Skill zawiera mapy decyzyjne, porównania REST vs GraphQL vs tRPC, wzorce odpowiedzi, wersjonowanie, autentykację i rate limiting. Zamiast gotowych rozwiązań, nauczysz się myśleć o projektowaniu API – od wyboru architektury, przez strukturę odpowiedzi, aż po bezpieczeństwo i dokumentację.

1. Zainstaluj skill api-patterns w swoim środowisku Claude. Skill zawiera 10 plików dokumentacji pogrupowanych w mapę treści – każdy plik dotyczy konkretnego aspektu projektowania API.

2. Zanim zaczniesz projektować API, przejrzyj listę kontrolną: czy wiesz, kto będzie konsumować Twoje API, jaki styl wybrać (REST/GraphQL/tRPC), jak strukturować odpowiedzi, jak wersjonować, jaką autentykację zastosować, czy potrzebujesz rate limitingu i jak dokumentować.

3. Gdy stoisz przed konkretną decyzją, otwórz odpowiedni plik z mapy treści. Na przykład jeśli nie wiesz, czy wybrać REST czy GraphQL, przejdź do api-style.md, gdzie znajdziesz drzewo decyzyjne. Dla REST przejdź do rest.md, dla GraphQL do graphql.md, dla projektów TypeScript fullstack do trpc.md.

4. Czytaj TYLKO pliki istotne dla Twojego problemu – skill zachęca do selektywnego czytania zamiast przeglądania całej dokumentacji. Jeśli projektując odpowiedź API nie wiesz, jak strukturować dane i obsługiwać błędy, otwórz response.md.

5. Dla zaawansowanych aspektów – wersjonowanie API (versioning.md), autentykacja i autoryzacja (auth.md), ochrona przed nadużyciami (rate-limiting.md), bezpieczeństwo (security-testing.md) – sięgnij do odpowiednich plików gdy będą Ci potrzebne.

6. Jeśli Twój projekt wymaga głębszej wiedzy z implementacji backendu, projektowania baz danych lub hardening bezpieczeństwa, skill wskazuje powiązane umiejętności – backend-development, database-design i security-hardening – których możesz użyć razem z api-patterns.