Rest Api

api-design-principles は、チェックリスト、参考ファイル、FastAPI テンプレートを使って REST / GraphQL API の設計とレビューを支援するスキルです。実装前に、リソース命名、HTTP セマンティクス、ページネーション、エラー設計、バージョニング、スキーマ構成の改善に役立ちます。

openapi-spec-generationは、design-first・code-first・ハイブリッドの各ワークフローで、REST API向けのOpenAPI 3.1仕様の作成と改善を支援します。新しいコントラクトの草案作成、既存仕様の磨き込み、ドキュメント整備、SDK生成、バリデーションまで、実用的なテンプレートと参照情報をもとに進めたいチームに向いています。