Swagger SPECをOpenAPI SPECに変換する方法

OpenOPI YAMLに変換しよう

RestAPIの定義をSwagger SPECを使用していたものの、APの移行にともなってOpenAPI SPECで書く必要があり機械的にできたらなぁ〜なんて思っていたらありました。

その名もswagger2openapです。

使い方

まずはswagger2openapをインストールしましょう。npmがない人は事前に入れておいてね。

npm install -g swagger2openapi

これで準備OKです。

swagger2openapi [filename]

で変換してくれます。
デフォルトでは生成する形式がJSONになっているので、YAML形式がいい場合は-yを、アウトプットファイルを指定したい場合は-o [out-filename]を指定しましょう。

アウトプットファイル指定しYAMLで出力したい場合のコマンドは以下の通り。

swagger2openapi -y -o output.yml input.yml

decimal型がOpenAPIにはなかったりしてそのままでつかえないこともあるので、公式ドキュメントを確認して修正、確認する必要はありそうです。