ローカル環境で Swagger 2.0 を OpenAPI 3 に変換する

swagger-converter をローカル環境で実行し、Swagger 2.0 を OpenAPI 3 に変換します。

1. swagger-converter の Image をダウンロードします。

   docker pull swaggerapi/swagger-converter:v1.0.4
   

2. swagger-converter を実行します。

   docker run -it -p 8080:8080 --name swagger-converter swaggerapi/swagger-converter:v1.0.4
   

3. curl コマンドで Swagger 2.0 の json ファイルを OpenAPI 3 に変換します。

   curl -X POST -H "Content-Type:application/json" -d @{SWAGGER_JSON_PATH} -o {OPENAPI_JSON_PATH} http://localhost:8080/api/convert
   

   • SWAGGER_JSON_PATH: Swagger 2.0 の json ファイルのパスです。
   • OPENAPI_JSON_PATH: OpenAPI 3 に変換した json ファイルのパスです。

   /Users/st-little/Downloads/swagger.json を変換して /Users/st-little/Downloads に保存する場合は次のコマンドになります。

   curl -X POST -H "Content-Type:application/json" -d @/Users/st-little/Downloads/swagger.json -o /Users/st-little/Downloads/openapi.json http://localhost:8080/api/convert