评论中的Arnaud是正确的,这里有两个单独的问题。
您是否要验证您的规格是有效的OpenAPI(fka.Swagger)规格
您可以
- 将您的规范复制到在线Swagger编辑器中,它将引发错误。快速浏览源代码并不能告诉我它是用来创建那些错误的,但是它似乎并没有联系服务器来实现。
- 使用Java 的官方swagger-parser。
- 将非官方的swagger-parser用于Javascript(浏览器或Node)。
或验证此规范的实现会产生与您的JSON模式有关的JSON?
换句话说,这是来自请求或响应正文的一些JSON,对吗?
Swagger的架构对象依赖于另一个称为JSON
Schema的标准,它实际上是对JSON(而不是端点或元数据)的描述。Swagger使用JSON模式的子集(缺少:
oneOf,,
patternProperties等等)。为此,您可以使用JSON模式验证器。这里列出了37个 ;
我将向此在线验证器大喊大叫,该验证器还支持YAML模式。
但是,当我说Swagger依赖于JSON API的子集时,我撒了谎。Swagger中有一些固定字段具有特殊含义,这些字段不是JSON
Schema的一部分。其中之一
discriminator是用于多态性。
我不知道可以处理的Swagger验证程序
discriminator。有很多工具可以摇摇欲坠,有些声称可以进行验证,但是许多工具都是废弃软件,用于旧版本,功能不完整,与其他技术捆绑在一起,依此类推。如果我缺少一个成熟且维护良好的库,我很想知道。
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)