OpenAPI - kocya-dev/note GitHub Wiki

• ReadableなOpenAPI定義ファイルを書く
• 【OpenAPI】Stoplight Studioを活用して快適＆高速にAPI定義を書く方法｜Offers Tech Blog
• Stoplight Studio×Redocで理想的なAPIリファレンスを作成してみた
• OpenAPI定義ファイルを分割して管理し易くする

tips

• openapi ローカルでmockサーバ立ち上げ

npm i  @stoplight/prism-cli
npx prism mock <yaml file name>

• html生成

npm i @redocly/cli
npx @redocly/cli build-docs <input yaml path> -o <output html path>

※ allOfを使った上書きも正しく反映される (https://qiita.com/tashinoso/items/1437ae404cf129d97f2a)