web-dev-qa-db-ja.com

OpenAPI 2.0をOpenAPI 3.0に変換する方法

OpenAPI 2.0の定義をOpenAPI 3.0に変換するツール/ライブラリはありますか？

私はググったが何も見つからなかった。

swaggeropenapi
3
Rumesh Madhusanka

Swagger Editor

OpenAPI 2.0定義を https://editor.swagger.io に貼り付け、編集> OpenAPI 3に変換を選択します。メニュー。

Swagger Editor conversion from OpenAPI 2.0 to OpenAPI 3.0

Swaggerコンバーター

OpenAPI 2.0およびSwagger 1.x定義をOpenAPI 3.0に変換します。

https://converter.swagger.io/api/convert?url=OAS2_YAML_OR_JSON_URL

これによりJSONが得られます。 YAMLが必要な場合は、Accept: application/yamlヘッダー：

curl "https://converter.swagger.io/api/convert?url=OAS2_YAML_OR_JSON_URL" -H "Accept: application/yaml" -o ./openapi.yaml

APIドキュメント： https://converter.swagger.io

GitHubリポジトリ： https://github.com/swagger-api/swagger-converter

Swagger Codegenバージョン3.x

OpenAPI 2.0およびSwagger 1.xの定義をOpenAPI 3.0に変換することもできます。 Swagger CodegenにはCLIバージョンがあります Mavenプラグイン 、 Dockerイメージ 。

コマンドラインバージョンを使用した例を次に示します（最新のJARは Maven Central からダウンロードできます）。コマンド全体を1行で記述します。使用する openapi-yamlはYAMLを取得し、openapiはJSONを取得します。

Java -jar swagger-codegen-cli-3.0.19.jar generate
     -l openapi-yaml
     -i https://petstore.swagger.io/v2/swagger.yaml
     -o OUT_DIR

GitHubリポジトリ： https://github.com/swagger-api/swagger-codegen

9
Helen