swagger

swagger官网编辑界面
辅助生成swagger文档

SwaggerUI

Swagger UI是通过读取Swagger Edit导出的YAML／JSON文件，来进行接口测试。Swgger UI的站点域名要和发送请求的域名一样。不然浏览器会报跨域错误。

安装

1.下载并且安装node.js
2. npm install -g http-server
3. 下载项目https://github.com/swagger-api/swagger-ui并且解压。
4. 设置HS_HOME,它的值等于hs.cmd的全路径,并把HS_HOME加入PATH环境变量中
5. 进入swagger-ui文件夹。运行hs -p 500
6. 进入http://127.0.0.1:500/dist/index.html就可以看到swagger页面了

使用
一.导入swagger.json文件
把之前Swagger Edit导出的swagger.json文件复制到dist文件夹里面，修改index.html的url路径，改成指向swagger.json。就可以读取json文件的内容了。

请求<http://127.0.0.1:500/dist/index.html> 效果如下：