API，协调前端与后端开发的连接点。

面临几个问题

1. API更新不及时，导致前端开发的接口没有及时更新而出现各种问题。

2. 文档描述得不准确

3. 没有统一的标准。

我们可以使用swagger editor， swagger ui。第一是编辑器，第二个是展示，部署用的。

 

在ubuntu 使用

先下载代码，然后用npm安装http-server

git clone https://github.com/swagger-api/swagger-editor.git

sudo  npm install -g http-server

 

http-server –p 2008 swagger-editor

执行上面的命令行在有可能出现错误，提示说 env里面没有node的命令，那是由于ubuntu使用了apt-get安装了node，为了避免包名冲突，重命名了node。执行下面的命令可以解决这个问题。

sudo ln -s /usr/bin/nodejs /usr/bin/node

 

 

至于swagger-ui，我们创建一个文件夹，比如mkdir node_app

git clone https://github.com/swagger-api/swagger-ui.git 到swagger文件里面

 

 npm init

 npm install express --save

 sudo npm install express --save

 cp -R  ~/swagger/swagger-ui/dist  public

 

上面步骤初始化了npm，然后把一些资源文件复制的到一个新建的目录public，然后修改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(3001, function () {      console.log('Example app listening on port 3001!');});

执行这个命令行，就会启动一个监听端口3001的服务

node index.js

 

执行命令测试，马上返回结果

curl localhost:3001    

Hello World!

 

访问路径即可使用网站：

localhost:3001/static/index.html

 

 

 

---

 

自己搭建了一个gogs的git网上

可以创建一个镜像，可以创建自己的私有的库。可以创建web hook