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

时间:2015-08-04 23:01:31

标签: python flask yaml swagger swagger-ui

我创建了一个扩展来制作Flask-Views Swaggable,这很简单,你在某个文件或docstring中放了一些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

enter image description here

swagger验证器说我的规格无效,但一切运作良好,为什么这说我的定义无效?

Anwers可以作为对github repo的贡献(那个示例app就在那里)

1 个答案:

答案 0 :(得分:0)

第一个问题是candidate_id模型下的req_query具有required属性。虽然属性是允许的,但在这种情况下,值类型是错误的并且无关紧要(这不是你如何使用它)。由于您在req_query级别提到数组中candidate_idrequired,因此您只需将其从属性定义中删除即可。

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