作为一名后端开发工程师每一次和前端对接都是一件痛苦的事情,还记得在大学时期做项目时还是通过写API文档给前端进行对接,然后每次更新接口或者增加一个新的接口都要修改一下文档然后发给前端人员结果接口文档一大堆而且不够清晰,毕业之后进了公司发现公司在wiki来写接口文档虽然比之前写接口文档方便了一点但是不方便测试。工作效率不够高,有一天在和大学同学吃饭讨论时,因为他是Java后端开发工程师,我就抱怨了一下。他向我推荐了一款产品,说可以很好解决我的问题。就是今天我要说的eolinker,回家之后抱着尝试的态度回家上去eolinker的官网看看,发现他们的界面挺简洁的,翻了一下说明文档,发现它的说明文档非常详细。我注册一个账号测试一下。发现它的功能刚好满足我的需要。现在为大家简单介绍一下它的功能。
1.查看项目情况
进入到项目之后,首先看到的是项目的全部详情,所有的项目信息都一目了然,包括接口数量、状态码数量、最后修改的日期和项目人数还有项目的动态等等。还可以在线分享项目和导出项目的数据等等,很方便我们进行项目的开发和管理。
2.接口管理功能
接口的列表非常清晰而且还有分组管理,对于修改接口和管理接口都非常方便,可以把不要的接口放进接口回收站里面如果误删了还可以恢复,这一点很方便。最重要的一点是新增一个接口可以对它进行标识,对接完把标识去掉,这样子方便我们进行对接。
在接口新增和修改页面可以看出接口信息功能很完善,让我们可以详细地展示接口的信息而且还可以进行详细说明还有高级mock方便测试。
3.接口测试
我觉得目前我们公司的wiki缺的就是这个功能了,而且这个功能最重要。eolinker提供了在线测试还有通过浏览器插件进行测试,如果只是在线测试是没有办法请求到本地服务器的,装了插件之后不仅支持本地测试还可以支持文件参数二的测试,这点很方便。基本的操作和我们平时用的postman、DHC差不多很方便。而且它还有一个测试的参数构造器,可以很方便地生成请求参数,对参数处理。极大地提高了我们的测试效率。
4.状态码管理
我觉得使用状态码来定义后端程序返回返回给前端的错误提示更好,以前我们经常返回一些文字给前端或者只是简单地返回失败和成功这样子的做法不是很好,这样子使得我们的产品不够友好或者交互性不够强,我觉得如果可以把所有的错误信息都能返回前端最好了,eolinker这一点很好地提醒了我,我觉得以后我们的项目有必要建立一套状态码,这样子可以反复使用而且对于错误的信息可以详细地返回给前端。
5.团队协作
可以通过邀请码邀请或者直接输入注册信息邀请同事进来,而且还有权限功能很方便我们进行管理。
大概功能就是上面的那种,具体还有其他让人眼前一亮的功能还需要各位的探索,希望这篇文章能够帮到那些有需要帮助的人。