Slide 1

Slide 1 text

モーリー Swaggerを使ってみた

Slide 2

Slide 2 text

名前 モーリー 職業 システムエンジニア 趣味 ポケポケにハマっています! 自己紹介 01

Slide 3

Slide 3 text

OpenAPIの仕様に沿ってRestAPIの設計を文書にまとめることができるツール Swaggerとは 02 Swagger Editor Swagger UI Swagger Codegen Swagger Core Swagger Parser etc

Slide 4

Slide 4 text

サンプル(一部のみ) 03 yaml形式で記載

Slide 5

Slide 5 text

VS Codeの連携方法 04 1. VS Codeの拡張機能 Swagger Viewer をインストール 2. VS Code の設定から Preview In Browser を有効にする 3. 「Cmd」+「Shift」+「P」で Preview Swagger を選択

Slide 6

Slide 6 text

URL:https://marketplace.visualstudio.com/items?itemName=Arjun.swagger-viewer 1 VS Codeの拡張機能 Swagger Viewer をインストール VS Codeの連携方法 04

Slide 7

Slide 7 text

2 VS Code の設定から Preview In Browser を有効にする VS Codeの連携方法 04

Slide 8

Slide 8 text

3 「Cmd」+「Shift」+「P」で Preview Swagger を選択 VS Codeの連携方法 04

Slide 9

Slide 9 text

サンプル(一部のみ)_再掲 04 yaml形式で記載

Slide 10

Slide 10 text

ブラウザからプレビューを確認可能 VS Codeの連携方法 04

Slide 11

Slide 11 text

デモ 05 Swagger起動した画面の共有

Slide 12

Slide 12 text

メ リ ッ ト デ メ リ ッ ト GitHubでドキュメント管理ができて楽 学習コストがかかる メリット・デメリット 05 統一した書きかたができる