如何从Swagger API声明生成JSON-Schema

Question

我有使用Swagger V1.2的服务的Swagger API声明。

我对Swagger最初的感觉是，它非常接近JSON模式（草案3和最近的草案4)，为请求和响应对象生成JSON模式相对容易。

问：有没有任何现有的项目或代码可以从Swagger API声明生成可用的JSON模式？

最好是JSON Schema Draft 4和使用Python（但我很乐意找到任何东西）。

Answer 1

在使用Swagger来指定REST API并在相关测试套件中重用它之后，我将与它分享我自己的经验（回答我自己的问题）。

规范的Swagger1.2和2.0状态，它只支持JSON模式草案4的子集。这意味着：

• 我们不能相信，swagger完全支持每个有效的JSON模式。
• 考虑到XML，Swagger只支持JSON Schema Draft 4提供的JSON结构子集的规范表示。

null

我花了一些时间编写一个库，它将采用Swagger API规范并创建JSON模式草案4。我放弃有几个原因：

• 一点都不容易
• 失望地发现，我只能使用JSON模式提供的子集。我们已经提出了一些JSON有效负载，必须开始修改它，以适应Swagger规范框架所允许的内容。

除了有非常漂亮的UI来显示和测试API（是的，每个人都同意，它在视觉上非常令人愉快）之外，我发现很奇怪，规范框架不允许我们使用我们想要的东西，而是给我们的设计增加了意想不到的限制。

好的问题是解决问题的一半。我的问题是错误的，因为它没有满足我真正的期望。更正的问题是：

使用什么规范框架和技术，使用任意JSON Schema Draft 4或W3C XML Schema 1.0定义的有效负载来指定REST API。

我对这样一个问题的回答是：

null

可能还有其他规范框架可用，但Swagger（既不是V1.2也不是V2.0)绝对不是这样。除了提供了很多特性（代码生成、非常好看的API文档以及更多）之外，它在提供上述更新问题的解决方案方面失败了。