RESTful api文档生成工具:apidoc
apidoc是一个简单的RESTful api文档生成工具,它从代码注释中提取特定格式的内容,生成文档。目前支持c系列注释风格的语言和ruby。具体文档可参考:http://apidoc.site/
/* @api get /users 获取所有的用户信息 @apiGroup users @apiQuery page int 显示第几页的内容 @apiQuery size int 每页显示的数量 @apiSuccess 200 ok @apiParam count int 符合条件的所有用户数量 @apiParam users array 用户列表。 @apiExample json { "count": 500, "users": [ {"id":1, "username": "admin1", "name": "管理员2"}, {"id":2, "username": "admin2", "name": "管理员2"} ], } @apiExmaple xml <users count="500"> <user id="1" username="admin1" name="管理员1" /> <user id="2" username="admin2" name="管理员2" /> </users> */
安装
go get github.com/caixw/apidoc
本文由用户 jopen 自行上传分享,仅供网友学习交流。所有权归原作者,若您的权利被侵害,请联系管理员。
转载本站原创文章,请注明出处,并保留原始链接、图片水印。
本站是一个以用户分享为主的开源技术平台,欢迎各类分享!