OpenAPIの記事一覧
OpenAPI に関する記事を 2 本まとめています。Spring Bootの実装・設計・運用の観点で関連テーマを横断して読めます。
-
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出力まで実践的に解説します。