我创建了一个扩展来制作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
swagger验证器说我的规格无效,但一切运作良好,为什么这说我的定义无效?
Anwers可以作为对github repo的贡献(那个示例app就在那里)
答案 0 :(得分:0)
第一个问题是candidate_id
模型下的req_query
具有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
。