api 接口管理工具

api 接口管理工具

如今，Web 应用的先后端分离事实上已经成为了你们都承认的一种开发方式，先后端分离以后，前端与后端都用接口（api）来沟通，这就须要咱们作好 API 接口管理，因此，此次来聊聊 API 接口管理工具。

API 接口管理工具大体分为线上工具和自建工具。

1. 线上工具

比较热门的线上工具备：

• eolinker
• apizza：界面与 postman 比较像
• easyapi
• apiview

2. 自建工具

企业通常都采用自建工具，本身维护一套 API 接口管理工具，比较热门的有：

• yapi：去哪儿出品，线上演示地址 http://yapi.demo.qunar.com
• RAP / rap2-delos + rap2-dolores：阿里出品，线上演示地址 http://rap2.taobao.org/
• easy-mock：线上演示地址 https://easy-mock.com/
• swagger：国外比较热门的接口管理工具

2.1 yapi

环境需求：Node.js (>= v7.6) & MongoDB (>= v2.6) & Git

yapi UI 很漂亮，操做很流畅，安装比较简单，使用也比较简单，不与其余第三方工具或语言绑定。

若是喜欢简单、UI 友好的，推荐使用这个。

安装：yapi#安装

2.2 RAP / rap2-delos + rap2-dolores

环境需求：Node.js (>= v8.9) & MySQL (>= v5.7) & Redis（>= v4.0）

rap 功能很是全，UI 不是很漂亮，安装比较复杂，使用也比较复杂，数据生成使用 mock.js。

若是对功能完善、系统稳定、用 mock.js 生成数据有偏好的，推荐使用这个。

RAP 目前有两个版本，第一个版本的 RAP 已经被官方废弃了，建议用第二个版本。

RAP2 分红了两个包：

• rap2-delos：后端数据 API 服务器
• rap2-dolores：前端静态资源

RAP2 的安装步骤要麻烦一些，rap2-delos 能够参考官方文档 rap2-delos#部署、非官方rap2-delos部署文档，rap2-dolores 能够参考官方文档 rap2-dolores#deployment-部署。

2.3 easy-mock

环境需求：Node.js (>= v8.9) & MongoDB (>= v3.4) & Redis（>= v4.0）

easy-mock UI 很漂亮，操做很流畅，安装比较简单，使用也比较简单，数据生成使用 mock.js，而且支持导入 Swagger Docs API。

若是喜欢简单、UI 友好的，而且喜欢用 mock.js 生成数据或者导入 Swagger Docs API 的，推荐使用这个。

安装：easy-mock#quick-start

2.4 swagger

Swagger 其实并非一个工具，而是一系列工具，或者说叫一个生态：

• OpenAPI-Specification：基于 yaml 语法格式定义的一套开放 API 文档规范
• swagger-ui：UI 展现库
• swagger-codegen：根据 Swagger 定义的 RESTful API 自动生成 Swagger 文档（for java）
• swagger-core：java 核心库
• swagger-editor：可视化编辑器
• ReDoc：生成格式优美的 UI 界面（第三方）
• swagger-node：for node.js
• go-swagger：for Go

如你所见，这个生态功能很是全，但使用很是复杂，入门坎比较高。

这套工具对后端很是有用，特别是 java 开发，能直接根据注释自动生成相应的 API 规范文档，而后直接根据这个 API 规范文档自动生成 UI 可视化界面与数据 Mock 服务器，而不是咱们手动建立。

安装：swagger

3. 其余工具

上面讲的，无论是线上工具仍是自建工具，都是接口集成工具，主要是为了提供数据 Mock 功能。

若是仅仅是为了以静态文本的形式作展现用，能够试试下面的一些工具：

3.1 Git 仓库 + Markdown

把接口文档单独建一个项目，使用 Markdown 的格式来书写。

了解 Markdown 语法。

3.2 leanote

相似网易云笔记、印象笔记的笔记管理工具。

了解 leanote。

3.3 gollum

基于 Git 的 wiki 系统。

了解 gollum。

3.4 wiki.js

基于 Node.js 的 wiki 系统。

了解 wiki.js。

后续

更多博客，查看 https://github.com/senntyou/blogs

做者：深予之 (@senntyou)

版权声明：自由转载-非商用-非衍生-保持署名（创意共享3.0许可证）