search

mominger / blog

Tech blog
45 stars 3 forks source link

接口管理平台对比 #20

Open mominger opened 4 years ago

mominger commented 4 years ago

接口管理平台对比

为何需要接口管理平台

  1. 文档维护: 于前端而言，后台提供的文档不规范，有markdown，word，甚至即时聊天软件沟通，后台接口是黑盒子，遇到问题，增删改查参数； 于后台而言，需撰写、维护冗余繁杂的文档。
  2. 前后端并行开发：前端为了并行开发，注入json静态数据。
  3. 接口数据的正确性：后台转测、上线前未做接口测试。导致某些视图或交互不是预期，碰到转测、上线就是熬夜加班。

市面上各接口平台对比

1. 热门程度

类型 公司 github stars(K) github地址
rap 阿里巴巴Mux团队 10.4 Rap
rap2 阿里巴巴Mux团队 5.8 Rap2
easy-mock 大搜车无线团队 7.7 easy-mock
YApi 去哪儿网大前端技术中心 15.1 YApi
Nei 网易前端事业部 0.83 Nei

rap已被放弃，启用了rap2
Nei 4月份才开源

2. 功能对比

类型 文档管理 Mock Server 接口调试 自动化测试 插件扩展 开源
rap2 ✓ ✓ ✕ ✕ ✕ ✓
easy-mock ✕ ✓ ✓ ✕ ✕ ✓
YApi ✓ ✓ ✓ ✓ ✓ ✓
Nei ✓ ✓ ✓ ✓ ✕ ✓

文档管理：指可以管理、维护接口，且导出接口文档
Mock Server：指支持构建mock假数据
接口调试：指接口的即时请求响应，比如 postman
自动化测试：指对接口进行测试，是否在转测时，上线前都一直表现如预期
插件扩展：指是否在关键点抛出钩子函数，支持程序员对各项功能的扩展，调整
开源：指代码在 github开源
rap2 导出的接口文档格式可阅读性太差
swagger2平台则需要结合 easy-mock postman 才能支持 mock、接口调试。swagger本身 也可以作为数据提供方，供上述平台比如YApi使用

3. 使用案例

类型 案例 案例地址
Rap2 阿里巴巴集团 蚂蚁金服 Boss直聘 苏州白鸽云信息技术有限公司 厦门优优汇联信息科技有限公司 Rap
easy-mock 大搜车 Ruff 七牛 恒达时讯 数字联盟 easy-mock
YApi 去哪儿 携程 艺龙 美团 百度 YApi

Rap2 没公布使用者，取的是 Rap的使用案例 Nei才开源，未公布使用案例。原来只有网易用户才能使用

4. 现状

类型 官网 最近几次发版
Rap2 Rap2 v2.1.5 v2.10.3 (2019-08-21) First (2019-01-17)
easy-mock easy-mock v1.6.0 (2018-03-14) v1.5.1 (2018-01-17)
YApi YApi v1.9.1 (2020-04-29) 1.9.0 (2020-03-11)
Nei Nei

Rap2 https://github.com/thx/rap2-delos/releases
easy-mock 发版日志 https://github.com/easy-mock/easy-mock/releases
YApi 发版日志 https://github.com/YMFE/yapi/releases
Nei 可能是网易内部使用原因，未找到发版日志

5. 结论

  1. 从github starts 和 发版本来看 YApi 仍非常活跃。Rap2 则停在2019年，作为Rap的替代版本，仅发了2版。easy-mock 停留在2018年。

  2. 从功能来看，YApi功能全，符合要求，且支持插件定制化扩展。 其次网易的Nei也算全面，只是4月份才开源，原先需网易用户才能使用。

  3. 从使用案例来看，YApi独占鳌头

反馈与建议