OpenAPI
参考URL
参考URL(これが一番参考になる)
openapiをチームに共有する
OpenAPIを分割する
コード自動生成やモックサーバーに活用させることで徹底したスキーマファーストな開発を行うことができる。
覚えるべき大項目
openapi: 3.0.3 # [必須] Open API バージョンを指定します
info: # [必須] API 定義の基本情報を記載します
...
servers: # API サーバの情報を記載します
...
paths: # [必須] エンド ポイントのリクエストやレスポンスを記載する。メインとなる部分
...
components: # 共通部分をここにまとめておきます
...