Как конвертировать спецификацию swagger 1.1 в swagger> = 1.2 spec - PullRequest
Новая
       6

Как конвертировать спецификацию swagger 1.1 в swagger> = 1.2 spec

0 голосов
/ 05 декабря 2018

Я пытаюсь сгенерировать код клиента для ядра C # / asp.net, чтобы использовать сервис, имеющий спецификацию swagger 1.1.(Сервис находится вне моего контроля).К сожалению, большинству современных инструментов требуется чванство 1.2 спец.Большинство инструментов даже требуют open-api 2.0.Даже большинство конвертеров начинаются с 1.2.Кто-нибудь знает инструмент для обновления с 1.1 до 1.2?

Я бы даже подумал переписать вручную, но нигде не могу найти, что изменилось между 1.1 и 1.2

1 Ответ

0 голосов
/ 06 декабря 2018

Прежде всего, 1.2 тоже очень старая версия.Рассмотрите возможность преобразования в OpenAPI 2.0 (используемый большинством инструментов в настоящее время) или, возможно, даже в OpenAPI 3.0 (последняя версия).

Swagger Codegen

Swagger Codegen может генерировать клиент / серверкод из спецификаций 1.x-3.0, а также может конвертировать Swagger 1.x в OpenAPI 2.0 или 3.0.

Для генерации клиента C # из спецификации Swagger 1.x с использованием Codegen CLI v. 2.x : 

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, Codegen CLI v. 2.x с аргументом -l swagger для получения JSON или -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.

...