接口文档完整样例

[cabbage217]

你好，我要要一份接口文档的完整要样例，主要是对返回数据不知道怎么写文档。感谢。

[xuke1668]

src/api/base.py文件中举例的几个接口里都有注释，接口文档就是根据这些注释生成的。
src/doc.py文件里是具体的生成逻辑。

你想看看样例，可以直接运行该项目，然后访问一下接口文档的页面，比如http://127.0.0.1:5000/api/doc/，然后就能看到最终的文档样式。