如何验证 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 模块。