最近公司要展新项目,上周开了两天的需求分析会,由于项目要求采用新的前后端分离的开发方式,所有数据都走接口调用,因此初步判断接口数量会非常庞大,就想着是否有什么接口管理的工具可以帮助减轻这块的工作量。
百度了一下,花了一周时间使用了国内外的几款产品(不得不说,目前这类的产品很少。。。),觉得国产的eolinker是做的最贴合我的需求的,因此特地记录一下,方便以后队友之间传播。
首先我的需求是:
1.可以很方便地对接口进行录入,并且最好可以读取代码;
2.记录的信息最好足够详细,方便前后端人员的对接工作;
3.可以对在线/本地接口进行测试,这样可以不用切换工具就能对开发和生产环境的项目进行测试;
4.团队协作管理,支持权限控制。因为我们的开发团队有接近20号人,也算个中型开发团队了,没有权限管理的话会非常头疼(曾经在这方面吃过亏,离职人员把源代码删了,虽然最后找了回来但还是费了很多时间)。
Eolinker除了不能读取代码之外(和他们公司沟通过,他们表示代码读取的灵活性不高,并且还会污染代码,因此目前采用录入的方式,但是后续会提供更多录入支持。不得不说他们的客服态度非常好,这点在国内公司真的少见),其他的需求都能完美的满足。而且在使用的过程中可以感受到产品团队花了非常多的心血在功能设计上,有很多独一无二的小功能但是很实用,比如接口回收站、日程记录等。
国外有一款产品Swagger支持代码读取,不过在数据的详细程度上还有本地化工作上的确逊色得多。
下面简单介绍一下日常的功能(以eolinker提供的demo项目为例),什么新建项目这些就不说了,着重说一下项目管理方面的,方便各位队友查阅:
1.查看项目情况:
进入到项目之后,首先看到的是项目的全部详情,包括接口数量、状态码数量、最后修改的日期和项目人数等,还有一个升级专业版本,但是免费版本的功能已经异常强大,所以嘛。。。先试试哈
右侧有非常方便的项目动态信息,什么人在什么时候改了什么接口的什么地方都可以一目了然,这点是国内外所有产品中做得最好的。
除此之外还可以导出项目到他们的开源版本,还有在线分享项目。
2.接口管理:
接口列表非常清晰,接口名称旁边的绿色点表示当前接口是启用状态,这点也是所有产品中独有的,异常贴心!还有接口最后更新人、接口更新日期等等。基本上简单的接口可以在列表就看懂是怎么用的。
接口详情里面的信息非常详细,因为手头暂时没有这么复杂的接口,因此盗了demo项目的接口信息来展示一下。接口的值可能性非常实用(同样是eolinker首创的功能),以后工作的时候,还请各位队友善用这个功能,记录每个参数的可能性和意义,方便前段人员进行对接。还支持富文本和markdown语法的接口详情,看了一下这个是支持图片上传的,很好。
3.状态码管理:
这个不用赘述了,基本上接口都有。不过这里提个意见,目前eolinker的接口和状态码还不能关联,最好以后可以关联在一起,这样查询接口对应的状态码和反向的查询都会方便很多。
4.团队协作:
直接输入队友的注册信息就可以邀请进来,不过人多的时候得要一个个输入是个不太友好的事情。(已经和产品团队提过,回复近期会增加邀请页面的功能,这个更新速度非常好)
5.接口测试:
这个是最重要的功能,eolinker提供了在线测试还有通过浏览器插件进行测试,如果只是在线测试是没有办法请求到本地服务器的,装了插件之后不仅支持本地测试还可以支持文件参数的测试,这点很方便。
进入到测试界面的方式也很简单,点击进入接口详情之后,点击上方的“测试”选项卡即可,基本的操作和之前用的DHC、POSTMAN之类的测试工具类似,就不赘述。
接下来说一个很叼的功能,就是测试的参数构造器,可以很方便地生成请求参数、对参数进行无限级别的处理(比如多次MD5之后再全部转成大写)!
随便点击一个想要构造的参数输入框,右侧就会出现一个“魔术棒”图标,点击就会出现下面的界面:
简单的点击即可完成操作,在一个星期的实际使用中,极大的提高了接口测试的效率。(我觉得这个功能应该放在付费版本好一点,这样我就心甘情愿掏钱了哈哈哈)
上面简单说了几点,除了这些之外还有历史版本回滚、接口回收站(恢复误删数据)、mock测试(需要专业版,不过目前注册有送半个月,试用了一下也非常方便,但和前端关系更加紧密一些,因此对我而言不常用),总而言之eolinker的功能基本满足我们公司日常开发的需求了。
写这篇博文的时候总是有些难以抑制的兴奋之情,觉得国产的产品也有如此用心的并且真的解决需求的不多,而eolinker绝对是让我眼前一亮的,希望他们能够一直走下去,我也算是为他们简单代言一下了。。。(不知道项目组能不能给我点小奖励作为代言费啥的哈)