Web API文档生成工具apidoc

详情请看转载http://www.jianshu.com/p/bb5a4f5e588a

详细文档 http://blog.youkuaiyun.com/lvbaolin123/article/details/52671677

window下安装http://www.bubuko.com/infodetail-948579.html

第一步,在要生成的项目下创建 apidoc.json、

{
  "name" : "APP接口",
  "version": "1.0.0",
  "title": "APP接口", 
  "description": ""
}

第二步,结合文档编写注释,

第三步.在要生成的项目下,按住左Shift，点击鼠标右键，选择“在此处打开命令窗口” 输入命令 

apidoc -i src -o ./doc

遇到的问题

1、apiGroup用中文

在你的每个分组下的API中添加以下注释（java）：
/**
* @apiDefine UserGroup
*
* 用户组
*/
那么在导航的测边栏apiGroup名就是中文的了 

2、测试总是返回 error：0

这个是 跨域导致的 你可以添加一行代码
java下的
```
response.addHeader("Access-Control-Allow-Origin", "*");
response.addHeader("Access-Control-Allow-Methods", "get, post, put, delete, options");
response.addHeader("Access-Control-Allow-Headers", "origin, content-type, accept");
response.addHeader("Access-Control-Allow-Credentials", "true");
```