Windows 搭建swagger editor 和swagger ui

来源:互联网 发布:暮光女 出柜 知乎 编辑:程序博客网 时间:2024/06/07 22:02

一,搭建swagger editor

要求:node.js环境

1,安装node.js

2, npm install;

3,

git clone https://github.com/swagger-api/swagger-editor.gitcd swagger-editornpm installnpm run buildnpm start
4,然后就根据网址启动swagger editor

二,搭建swagger ui

 1,

git clone https://github.com/swagger-api/swagger-ui.git
2,安装express,官网网址:http://www.expressjs.com.cn/4x/api.html

3,

mkdir node_app
4,
cd node_ap
npm init
npm install express --save
vim index.js
将一下代码粘贴到index.js中

var express = require('express');
var app = express();
app.use('/static', express.static('public'));
app.get('/', function (req, res) {
  res.send('Hello World!');
  });
 
  app.listen(3000, function () {
    console.log('Example app listening on port 3000!');
    });
5,mkdir public
6,
cd public
将下载的swagger-ui中的dist文件夹下的内容拷贝到public路径下
7,
node index.js
8,然后就可以根据网址访问swagger ui了
三:将swagger-editor中编辑的文档拷贝到public路径下,然后更改dist下的index.xml,将路径中的swagger.json给为你编辑的swagger-editor,就可以看到自己编写的文档了。


注意,自己编辑的文档中一定要有认证,否则会出现跨域问题。



原创粉丝点击