开发API必备神器---ApiDoc的使用

在开发后台接口的过程中，我们肯定要提供一份api接口文档给终端app。

目前大多数的app的接口请求应该都是http+json的方式。 但是一直苦于做不出份漂亮的api文档，用word写，也太丑了。。怎么才能做出一份像腾讯、新浪微博等各种开放api平台那样漂亮的api文档呢？找了好久发现了今天的主角-apidoc。

官网地址：http://apidocjs.com

开放API已经成为当下主流平台的一个要素，特别对于社交、电商类的平台开放API更成为了竞争力的一种。开放API文档的完整性、可阅读性往往影响着接入方是否能顺利地、快速地接入到平台，一份好的、统一的API文档也是开放平台不可或缺的要素。

apidoc是通过源码中的注释来生成API文档，所以只要识别兼容现今大部分流行语言的注释方法便达到了兼容语言的效果。

有了它，我们只需要在写源码的时候顺手写上一些简单的注释，就可以生成出漂亮的文档了（当然，有同学会问文档不是先定义的吗？你把接口的源码声明好不就ok啦？或者你写点其他的语言也行啊。。 最简单的就是学习下javascript，只要学会怎么创建js文件，然后怎么声明function，给function添加注释即可，实在写不了源码，写一个简单的js文件，然后用apidoc生成一下就出文档了。大笑）。

它可以对API的各种版本等级进行对比。所以无论是前端开发人员还是你都可以追溯API版本的变化。

支持多种语言：C#,
Go, Dart, Java, JavaScript, PHP, TypeScript (all DocStyle capable languages)，CoffeeScript，Erlang，Perl，Python，Ruby。

使用步骤：

1.安装nodejs。去http://www.nodejs.org/下载安装一个nodejs；

2.安装apidoc：命令行输入：npm install apidoc -g 貌似是在线安装的，稍等一下即可。

1. 准备一个目录myapp，下面放源码文件，源码文件中要按照apidoc的规范写好注释。具体规范参见官网