如何验证 openapi 3.0.0 yaml 规范？

Question

我有一个 yaml 规范，已从 swagger 2.0 更新到 openapi 3.0.0。

该文件本身大约有 7,000 行，因此手动验证具有挑战性。

我需要弄清楚我拥有的哪些标签不再与 openapi 3.0.0 兼容。 如何验证我的架构？ 有没有我可以使用的命令行工具？

我不想在线复制/粘贴此代码，因为我不想公开所有路线。

Answer 1

Swagger 编辑器

https://editor.swagger.io在客户端执行验证，这意味着您的定义不会发送到任何地方。 您也可以在本地运行编辑器，例如离线运行。

笔记：

• 由于延迟加载，您可能需要展开 UI 面板中的所有操作和模型以查看所有错误。

• 除错误列表外，警告显示为装订线图标。

其他验证器

https://openapi.tools有一个OpenAPI 验证工具列表，包括命令行工具和 Node.js 模块。

Answer 2

在 Visual Studio 代码上使用 openapi-lint 扩展并记住将您的文件命名为*openapi.json, *openapi.yaml, *openapi.yml, *oas3.json, *oas3.yml, *oas3yaml 。

Answer 3

我使用swagger-cli 。 它是一个支持$ref的验证器和打包器。