Как проверить openapi 3.0.0 yaml spe c?

Question

У меня есть спецификация yaml, которая была обновлена ​​с swagger 2.0 до openapi 3.0.0.

Сам файл содержит около 7 000 строк, поэтому его сложно проверить вручную.

I нужно выяснить, какие теги у меня больше не совместимы с openapi 3.0.0. Как я могу проверить свою схему? Могу ли я использовать какие-либо инструменты командной строки?

Я не хочу копировать / вставлять этот код где-нибудь в Интернете, потому что я не хочу раскрывать все маршруты публично.

Answer 1

Используйте расширение openapi-lint для кода Visual Studio и не забудьте назвать ваш файл как *openapi.json, *openapi.yaml, *openapi.yml, *oas3.json, *oas3.yml, *oas3yaml.

Answer 2

Swagger Editor

https://editor.swagger.io выполняет проверку на стороне клиента , то есть ваше определение никуда не отправляется. Вы также можете запустить редактор локально , например, в автономном режиме.

Примечания:

• Из-за отложенной загрузки может потребоваться развернуть все операции и модели на панели пользовательского интерфейса, чтобы увидеть все ошибки.

• Предупреждения отображаются в виде значков желоба, кроме списка ошибок.

Другие средства проверки

https://openapi.tools содержит список инструментов проверки OpenAPI , включая инструменты командной строки и Node.js модулей.