有一定工作年限的人一定会接触过通过word文档或者wiki的方式来进行接口对接交流的介质。后来为了方便协作修改接口,又逐渐的开始有人通过markdown文档,提交到版本管理系统的方式来编写接口。
后来随着浏览器的发展,出现了有利于接口调试的插件,最常见的就是postman
,可以很方便的向接口发起post和get请求,并附加各种请求头和cookie等,并且支持编写接口测试脚本来做接口测试。您也可以把postman当做接口文档来使用,但是作为团队工具还是不太方便,并且是收费的。
后来出现了一个框架级的接口工具:swagger。可以通过代码注解自动生成文档的源文件(swagger.json),然后渲染成ui,通过ui界面查看接口,以及进行接口调用。
同时也有一些第三方开源的接口系统开始涌现:
- RAP:阿里开发的RAP,是一个可视化接口管理工具 通过分析接口结构,动态生成模拟数据,校验真实接口正确性,围绕接口定义,通过一系列自动化工具提升我们的协作效率。可以通过RAP按照项目来管理接口,在线编辑接口,方便团队共享,同时会根据接口文档生成mock接口,方便接口调试。
- Yapi:去哪里开发的高效、易用、功能强大的API管理平台,提供项目管理,接口管理,MockServer,在线调试功能,支持swagger文档的导入。
对比下各个工具: