handling-api-errors
Ustandaryzuj obsługę błędów API z kodami HTTP i odpowiedziami RFC 7807
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do implementacji spójnej obsługi błędów w API. Konwertuje wyjątki frameworka, błędy walidacji, problemy bazy danych i awarie usług upstream w ustandaryzowane, czytelne dla maszyn odpowiedzi z właściwymi kodami HTTP. Wykorzystuje format RFC 7807 Problem Details, centralizowane middleware błędów, typizowane klasy wyjątków i monitorowanie produkcyjne. Obsługuje Express, FastAPI, Spring Boot i Gin.
Jak używać
Zainstaluj skill w swoim projekcie Claude Code lub Codex, upewniając się, że masz dostęp do narzędzi Read, Write, Edit, Grep, Glob i Bash z uprawnieniami api:error-*.
Wyzwól skill frazami takimi jak "add error handling", "standardize errors" lub "implement error responses" w kontekście swojego API.
Skill przeskanuje istniejący kod za pomocą Grep, aby znaleźć bloki try/catch, middleware błędów i handlery wyjątków, identyfikując niespójne formaty odpowiedzi błędów na różnych endpointach.
Zdefiniuj ustandaryzowaną kopertę odpowiedzi błędu zgodnie z RFC 7807, zawierającą: type (URI identyfikujący typ błędu), title (czytelny dla człowieka opis), status (kod HTTP), detail (szczegółowe wyjaśnienie) i instance (ścieżka żądania).
Utwórz typizowane klasy błędów dla każdej kategorii: ValidationError (400), AuthenticationError (401), AuthorizationError (403), NotFoundError (404), ConflictError (409) i RateLimitError (429).
Implementuj centralizowane middleware błędów, które przechwytuje wyjątki, mapuje je na odpowiednie kody statusu, loguje zdarzenia błędów z ID korelacji i wysyła dane do serwisu monitorowania (Sentry, Bugsnag, Rollbar).