今天小编就为大家分享一篇使用apiDoc实现python接口文档编写，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
apiDoc的安装
npm install apidoc -g
点击官方文档
生成api的终端命令：apidoc -i 代码所在路径-o 生成文件的路径
接口文档的编写
文件的简介
project的介绍写在单独的json文件中apidoc.json：
{ "name": "project_n<b style="color:transparent">来源gao@dai!ma.com搞$代^码网</b>ame", "version": "0.1.0", "description": "who am i ,what i can do ", "title": " title of the html that generated by apiDoc", "sampleUrl" : "https://127.0.0.1:8000"}
具体api的书写模版
""" @api {methods} url description @apiName unique_name @apiGroup group @apiParam {type} field description @apiSuccessExample {json} Success-Response: HTTP/1.1 200 OK { "errno":200, "errmsg":errmsg, } @apiError errortype description. @apiErrorExample {json} Error-Response: HTTP/1.1 200 OK { "errno":401 "errmsg": "UserNotFound" } """
以上这篇使用apiDoc实现python接口文档编写就是小编分享给大家的全部内容了，希望能给大家一个参考，也希望大家多多支持gaodaima搞代码网。
以上就是使用apiDoc实现python接口文档编写的详细内容，更多请关注gaodaima搞代码网其它相关文章！
搞代码网（gaodaima.com）提供的所有资源部分来自互联网，如果有侵犯您的版权或其他权益，请说明详细缘由并提供版权或权益证明然后发送到邮箱[email protected]，我们会在看到邮件的第一时间内为您处理，或直接联系QQ：872152909。本网站采用BY-NC-SA协议进行授权
转载请注明原文链接：使用apiDoc实现python接口文档编写
转载请注明原文链接：使用apiDoc实现python接口文档编写
