平台选型
Apidoc
文档参考：http://apidocjs.com
优点
文档齐全，操作简单，ui清晰，代码注解查询性强，语言支持多元化，写接口方便
缺点
需要配合发布方案
备选方案
doxmate 和apidoc类似，生成的页面也很精美，同样支持注释风格内容解析。缺点是依赖较多，操作较为复杂。
犀鸟Api
是一个后台存储形接口平台 ，优势是简单即时，缺点是ui不足，修改需登录平台，查询需登录页面，录入效率略低。
swagger
支持 php,java ，通过注解生成json，然后通过不同的ui展现。也是不错的形式，可以试试，类似apidoc
rap
是一个在线接口管理工具，类似于 犀鸟。也不错