api 接口管理工具

栏目: 后端 · 发布时间: 5年前

内容简介:现在,Web 应用的前后端分离事实上已经成为了大家都认可的一种开发方式,前后端分离之后,前端与后端都用接口(api)来沟通,这就需要我们做好 API 接口管理,所以,这次来聊聊 API 接口管理工具。API 接口管理工具大致分为线上工具和自建工具。比较热门的线上工具有:

api 接口管理工具

现在,Web 应用的前后端分离事实上已经成为了大家都认可的一种开发方式,前后端分离之后,前端与后端都用接口(api)来沟通,这就需要我们做好 API 接口管理,所以,这次来聊聊 API 接口管理工具。

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

1. 线上工具

比较热门的线上工具有:

2. 自建工具

企业一般都采用自建工具,自己维护一套 API 接口管理工具,比较热门的有:

2.1 yapi

api 接口管理工具

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

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

如果喜欢简单、UI 友好的,推荐使用这个。

安装: yapi#安装

2.2 RAP / rap2-delos + rap2-dolores

api 接口管理工具

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

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

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

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

RAP2 分成了两个包:

RAP2 的安装步骤要麻烦一些, rap2-delos 可以参考官方文档 rap2-delos#部署非官方rap2-delos部署文档rap2-dolores 可以参考官方文档 rap2-dolores#deployment-部署

2.3 easy-mock

api 接口管理工具

环境需求: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 其实并不是一个工具,而是一系列工具,或者说叫一个生态:

如你所见,这个生态功能非常全,但使用非常复杂,入门坎比较高。

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

安装: swagger

3. 其他工具

上面讲的,不管是线上工具还是自建工具,都是接口集成工具,主要是为了提供数据 Mock 功能。

如果仅仅是为了以静态文本的形式做展示用,可以试试下面的一些工具:

3.1 Git 仓库 + Markdown

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

了解 Markdown 语法

3.2 leanote

api 接口管理工具

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

了解 leanote

3.3 gollum

基于 Git 的 wiki 系统。

了解 gollum

3.4 wiki.js

基于 Node.js 的 wiki 系统。

了解 wiki.js

后续

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

作者: 深予之 (@senntyou)

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


以上所述就是小编给大家介绍的《api 接口管理工具》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

离心力:互联网历史与数字化未来

离心力:互联网历史与数字化未来

[英] 乔尼·赖安(Johnny Ryan) / 段铁铮 / 译言·东西文库/电子工业出版社 / 2018-2-1 / 68.00元

★一部详实、严谨的互联网史著作; ★哈佛、斯坦福等高校学生必读书目; ★《互联网的未来》作者乔纳森·L. 齐特雷恩,《独立报》《爱尔兰时报》等知名作者和国外媒体联合推荐。 【内容简介】 虽然互联网从诞生至今,不过是五六十年,但我们已然有必要整理其丰富的历史。未来的数字世界不仅取决于我 们的设想,也取决于它的发展历程,以及互联网伟大先驱们的理想和信念。 本书作者乔尼· ......一起来看看 《离心力:互联网历史与数字化未来》 这本书的介绍吧!

JSON 在线解析
JSON 在线解析

在线 JSON 格式化工具

SHA 加密
SHA 加密

SHA 加密工具