为什么 Swagger 在我的规范中使类型 long、boolean 和 object 无效？

Question

我创建了一个扩展来使 Flask-Views Swaggable，这很简单，你将一些 YAML 定义放在某个文件或文档字符串中，Flasgger 负责创建 API 规范并公开 Swagger UI。

Github：https://github.com/rochacbruno/flasgger
示例APP：http://flasgger-rochacbruno.rhcloud.com/apidocs/index.html?url=/v2/spec

现在我遇到了一个问题：

http://online.swagger.io/validator/debug?url=http://flasgger-rochacbruno.rhcloud.com/v2/spec

swagger 验证器说我的规范无效，但一切正常，为什么会说我的定义无效？

Anwers 可以作为对 github 存储库的贡献（该示例应用程序就在那里）

Answer 1

第一个问题是您在req_query 模型下的candidate_id 具有required 属性。虽然该属性是允许的，但在这种情况下，值类型是错误的且无关紧要（这不是您使用它的方式）。由于在req_query 级别您提到candidate_id 是数组中的required，您只需将其从属性定义中删除即可。

第二个问题是long 不是有效类型。如果您查看https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#data-types，您会发现long 转换为type 是integer 和format 是int64。