swagger，一款api测试工具，详细介绍参考官网：http://swagger.io/ ，这里主要记录下怎么将swagger api应用到我们的node服务中：
1、任意新建node api项目，使用npm init即可
2、安装依赖：
cnpm i express body-parser --save
其中express作为api框架，当然你也可以使用其它的，比如thinkjs、koa、koahub、阿里的egg等等（框架只是一种工具），body-parser用来解析json格式的请求。
3、新建index.js作为服务类，简单代码如下：
var express = require("express");
var app = express();
var routes = require('./routes/index');
var bodyParser = require('body-parser');
app.use(bodyParser.json()); // for parsing application/json
app.use(bodyParser.urlencoded({ extended: true })); // for parsing application/x-www-form-urlencoded
app.use("/static", express.static("public")); //配置swagger文档
routes(app);
app.listen(3000, function() {
console.log("server listening at port 3000");
});
这里的话，我们设置静态目录为public，路由文件为routes文件夹下的index.js文件，那么响应地创建两个文件夹，分别为：public（用来存放swagger文件）、routes（存放各种路由请求）。
4、下载swagger必须文件并解压到public下
下载地址为：https://github.com/swagger-api/swagger-ui 这里取dist文件夹下的所有文件直接放入public里面，在打开该网址：http://editor.swagger.io/#!/ 点击如下下载json配置文件（命名随意）：
这样一来，public目录下面的文件结构类似如下：
5、修改public目录下的index.html文件的url为刚才的json文件名称
6、启动node服务，打开public下的index.html，在浏览器端查看效果
最后：
1、想要api文档显示如何内容可直接编辑下载来的json文件即可，这里推荐一个网站：http://www.sosoapi.com/ 可以直接在线编辑swagger api文档，支持在线预览、导出等功能，比较方便
2、使用swagger在线测试的时候一定要主要跨域问题，否则可能导致实际已经发送了请求但是浏览器查看时却显示“no content”，这时浏览器的concole一定打印了跨域失败提示，解决有很多种，比如：服务端设置跨域请求头信息、浏览器允许跨域等
3、demo地址戳这里：https://github.com/caiya/node_app