やりたいこと 最近の開発でSwaggerを使ってAPI定義を書くことが多いが、APIが増えてくるとSwaggerが肥大化して辛いのでファイルを分割管理したい! 複数のAPIを1ファイルに定義した場合にswagger-uiのGUIだとちょっと見にくいなーと感じたので イカした見た目で確認できるようにしたい! やらないこと CI ここはとりあえずdockerで確認できるところまで 登場人物の概要 正式名称はOpenAPI-Specification(OAS) OpenAPI Initiative(OAI)というコミュニティによって定義されているRESTful APIの標準仕様 JSON/YAML形式で作成可能 Swagger OpenAPI仕様に基づいて構築されたオープンソースツールのセット 主要ツール Swagger Editor Swgger UI Swagger Codegen