OpenAPIの記事一覧
OpenAPI に関する記事を 3 本まとめています。Spring Bootの実装・設計・運用の観点で関連テーマを横断して読めます。
-
Spring REST DocsとSpringdoc OpenAPIの違いと使い分け
Spring REST DocsとSpringdoc OpenAPIを生成方式・正確性・運用負荷の観点から比較し、チーム規模やAPI用途に応じた選定基準と併用パターンを解説します。
-
Spring Boot REST APIのバージョニング戦略 - URLパス・ヘッダー・Content-Typeの使い分け
Spring BootでREST APIをバージョニングする3つの方式（URIパス・カスタムヘッダー・Acceptヘッダー）を実装コード付きで比較。自チームのAPI特性に合った方式を選ぶための判断基準とSwagger UI統合例も解説します。
-
Spring BootでOpenAPI（Swagger UI）を使ってREST APIドキュメントを自動生成する方法
springdoc-openapiの導入からアノテーションによるドキュメント強化、JWT認証付きエンドポイントへのBearerトークン設定、YAML出力まで実践的に解説します。