Open4
【API設計】OpenAPI・Swaggerについて
OpenAPI・Swaggerについて
Swaggerとは?
- SwaggerはREST APIを記述するためのインターフェース言語
- JSNOやYAMLで記載する
- サードパーティ製ツールを仕様することで高品質のドキュメントやスタブを自動生成できる
REST APIの開発元はSwaggerで記述することで、サードパティ製の様々なサポートツールを利用することができます。
VSCodeにSwaggerViewerを導入する
拡張機能Swagger Viewer を追加する
VSCode用の拡張機能「Swagger Viewer」を使うことで、VSCodeでSwaggerを編集しながらプレビューを動的に生成することができます。
Preview方法
- Shift+command+pでコマンドパレットを開く(WindowsはShift+Alt+p)
- コマンドパレットからPreview Swaggerを選択
Swagger Editor
参考・引用
Swagger と Mock Server作成
OpenAPI Generator