当前位置: 首页 > 知识库问答 >
问题:

如何验证 openapi 3.0.0 yaml 规范?

巫英纵
2023-03-14

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

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

我需要找出哪些标记不再与openapi 3.0.0兼容。如何验证我的模式?有没有我可以使用的命令行工具?

我不想将此代码复制/粘贴到在线某个地方,因为我不想公开所有路由。

共有3个答案

水瀚漠
2023-03-14

我使用swagger-cli。它是一个验证器和捆绑器,支持$ref等。

郎正初
2023-03-14

在visual studio代码上使用openapi-lint扩展,并记住将文件命名为< code>*openapi.json,*openapi.yaml,*openapi.yml,*oas3.json,*oas3.yml,*oas3yaml。

杨骁
2023-03-14

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

笔记:

>

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

    除了错误列表之外,警告显示为装订线图标。

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

  •  类似资料:
    • 验证规则的定义通常有两种方式,如果你使用了验证器的话,通常通过rule属性定义验证规则,而如果使用的是独立验证的话,则是通过rule方法进行定义。 属性定义 属性定义方式仅限于验证器,通常类似于下面的方式: <?php namespace app\index\validate; use think\Validate; class User extends Validate { prot

    • iam试图验证一些可能包含swagger规范的字符串。我正在尝试使用swagger解析器。 以下代码不起作用。我只收到消息:“[属性不是]类型” swagger规范是从xml文件中读出的。 这个方法是错误的吗?或者。错误消息的含义是什么?我只想知道字符串是否包含JSON格式的有效Swagger规范。 谢谢你的帮助。 更新:问题已解决 据我所知,如果字符串不是json有效的,就会抛出错误。首先我检查

    • 问题内容: 如何验证文本字段以仅在Swing中的小数点后输入4位数字? 问题答案: 可以使用进行Swing中的任何验证。 1.首先创建自己的输入验证器: 2.然后将该类的实例分配给您的文本字段。(实际上任何都可以验证) 当然,您也可以使用匿名内部类,但是如果将验证器也用于其他组件,则普通类会更好。 还可以查看SDK文档:JComponent#setInputVerifier。

    • 我正在尝试验证密码字段是否存在。我想允许某人编辑用户,他们可能想更改用户密码,也可能不想更改用户密码。所以我想我可以使用Laravels验证规则,特别是“有时”规则来实现这一点。我有一套规则: 例如,对于其他字段,通常会有其他规则,而对于密码,则会有更严格的规则。如果传递的数据中存在密码字段,我希望这只应用min:8规则,但是如果我将密码字段留空,则会出现一个验证错误,表明密码字段是必需的。 我不

    • 如何在验证器中添加密码验证规则? 验证规则: 密码包含以下五个类别中至少三个类别的字符: 英文大写字符(A–Z) 英文小写字符(a–z) 以10位数字(0–9)为基数 非字母数字(例如:!、$、#或%) Unicode字符 如何在验证器规则中添加上述规则? 我的代码在这里

    • 我做了一个自定义验证规则,它迭代一个包含键