根据Swagger API模式验证JSON

Question

我从一些JSON文件中创建了一个API规范，并尝试测试这些文件是否符合API规范。

有一些很好的工具可以验证JSON模式，但是我没有机会找到一个工具来验证在Swagger（创建API模式的工具）中创建的规范。我找到的唯一解决方案是在Swagger-Editor中生成客户端/服务器，这很麻烦。

是否已经有一个现有工具可以根据Swagger模式验证JSON？

Answer 1

如果托管了Swagger JSON，则可以使用以下url：http://online.swagger.io/validator/debug?url=your_url

Answer 2

艾特莱森的swagger-Request est-validator是一个Java库，可以进行这样的验证：

一个Java库，用于根据OpenAPI/Swagger规范验证请求/响应。包括对Swagger v2和OpenAPI v3规范的支持，以及对通用模拟和测试库的适配器。

核心库不依赖于任何特定的HTTP库，但它们还提供了与Spring MVC、MockMVC、REST Asared等集成的附加模块。

还有一个swagger模式验证器，可以根据swagger V2定义验证JSON文档（免责声明：我是作者）。不过，这个Java库不如Atlassian的完整。

Answer 3

阿尔诺在评论中说，这里有两个独立的问题，这是正确的。

你想验证你的规范是有效的OpenAPI（fka.Swagger）规范吗

你可以

• 将您的规范复制到在线Swagger编辑器，它将抛出错误。快速浏览源代码并没有告诉我它使用了什么来创建这些错误，但它似乎并没有联系服务器来创建这些错误

或者验证此规范的实现是否会生成对您的JSON模式有效的JSON？

换句话说，这里有一些来自请求或响应体的JSON，对吗？

Swagger依赖另一个称为JSON Schema的标准作为其模式对象，这些对象实际上描述了JSON（而不是endpoint或元数据）。Swagger使用JSON Schema的一个子集（缺少：oneOf、模式属性等）。为此，您可以使用JSON模式验证器。这里列出了37个；我将为这个也支持YAML模式的在线验证器大喊大叫。

但是，当我说Swagger依赖于JSON API的子集时，我撒谎了。在不属于JSON模式的Swagger中，有一些固定字段具有特殊意义。其中之一是用于多态性的鉴别器。我不知道有一个招摇验证器可以处理鉴别器。有很多用于swagger的工具，有些声称可以进行验证，但许多都是弃用软件，用于旧版本，功能不完整，与其他技术挂钩，等等。如果有一个成熟且维护良好的图书馆，我很想知道。