如何将swagger 1.1规范转换为swagger> = 1.2 spec

Question

我正在尝试为C＃/ asp.net核心生成客户端代码，以使用具有swagger 1.1规范的服务。 （该服务不受我的控制）。不幸的是，大多数最新工具需要一个swagger 1.2规范。大多数工具甚至需要open-api 2.0。甚至大多数转换器都从1.2开始。有人知道从1.1升级到1.2的工具吗？

我甚至考虑手动重写，但我无法找到1.1和1.2之间的任何变化

Answer 1

首先，1.2也是一个非常古老的版本。考虑转换为OpenAPI 2.0（现在大多数工具使用）或甚至OpenAPI 3.0（最新版本）。

Swagger Codegen

Swagger Codegen可以从1.x-3.0规范生成客户端/服务器代码，也可以将Swagger 1.x转换为OpenAPI 2.0或3.0。

使用Codegen CLI v. 2.x从Swagger 1.x规范生成C＃客户端：

java -jar swagger-codegen-cli-2.4.0.jar generate
     -i http://path/to/spec.json
     -l csharp
     -o ./csharp-client

要将Swagger 1.x转换为OpenAPI 2.0，请使用-l swagger参数将Codegen CLI v.2.x转换为获取JAM或-l swagger-yaml以获取YAML。

java -jar swagger-codegen-cli-2.4.0.jar generate
     -i http://path/to/spec.json
     -l swagger
     -o ./converted

要转换为OpenAPI 3.0，请使用带有Codegen CLI v. 3.x参数的-l openapi来获取JSON或-l openapi-yaml以获取YAML。

java -jar swagger-codegen-cli-3.0.3.jar generate
     -i http://path/to/spec.json
     -l openapi
     -o ./converted

API Transformer

API Transformer声称支持Swagger 1.x - > 1.2 / 2.0 / 3.0转换。