Swaggerを使ってみた(2024/12/05)

LT会発表資料

Swagger Viewer
https://marketplace.visualstudio.com/items?itemName=Arjun.swagger-viewer

Transcript

1. モーリー Swaggerを使ってみた
2. 名前 モーリー 職業 システムエンジニア 趣味 ポケポケにハマっています！ 自己紹介 01
3. OpenAPIの仕様に沿ってRestAPIの設計を文書にまとめることができるツール Swaggerとは 02 Swagger Editor Swagger UI Swagger Codegen Swagger Core Swagger Parser etc
4. サンプル(一部のみ) 03 yaml形式で記載
5. VS Codeの連携方法 04 1. VS Codeの拡張機能　Swagger Viewer をインストール 2. VS Code の設定から Preview In Browser を有効にする 3. 「Cmd」+「Shift」+「P」で Preview Swagger を選択
6. URL：https://marketplace.visualstudio.com/items?itemName=Arjun.swagger-viewer 1 VS Codeの拡張機能　Swagger Viewer をインストール VS Codeの連携方法 04
7. 2 VS Code の設定から Preview In Browser を有効にする VS Codeの連携方法 04
8. 3 「Cmd」+「Shift」+「P」で Preview Swagger を選択 VS Codeの連携方法 04
9. サンプル(一部のみ)_再掲 04 yaml形式で記載
10. ブラウザからプレビューを確認可能 VS Codeの連携方法 04
11. デモ 05 Swagger起動した画面の共有
12. メ リ ッ ト デ メ リ ッ ト GitHubでドキュメント管理ができて楽 学習コストがかかる メリット・デメリット 05 統一した書きかたができる