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にはなかったりしてそのままでつかえないこともあるので、公式ドキュメントを確認して修正、確認する必要はありそうです。