Swaggerから静的HTMLを生成する


Swaggerから静的(Webサーバ不要でローカルに保存したファイルをブラウザで開いて表示できる)HTMLを生成する方法を調べました。

(1) redoc-cli

redoc-cli を使うとコマンドラインでSwaggerファイルを静的HTMLに変換できる。

インストール

npm install -g redoc-cli

静的HTML生成

redoc-cli bundle [Swaggerファイル]

(2) Swagger-UI

SwaggerUIBundleのspecプロパティにJSON形式のSwaggerオブジェクトを渡すことで、静的HTMLを作成できる。

参考