接口对接实在太难了!

降本增效是企业追求的永恒目标。

如今,前后端分离早已成为互联网的标配,大家在享受这种开发模式带来的便利同时,也体会到一些痛点,比如:

一个需要几十个、上百个应用协作配合的项目,其中可能涉及到成百上千个API——API的管理逐渐成为开发、联调、测试中的痛点问题。

API研发和联调时存在的痛点:

开发团队使用多个API工具 (Postman、Yapi、Swagger等),多个工具之间数据难以打通;

  • API文档编写繁琐、设计不规范、缺乏统一文档格式等;

  • 缺乏版本管理,API变更没有通知;

  • 测试人员难以维护测试用例,大量使用脚本的方式写自动化测试,学习、编写和维护的成本都很高。

痛点解决路径

  • DTDD(文档与测试驱动开发)

  • 形成标准文档,让各个团队(开发,测试,运维)协作有迹可循

  • 用测试结果,推动项目进度,团队沟通更加通畅,项目管理可量化

API管理之路

起初我们用Swagger进行接口管理,但是发现它在调式功能方面非常弱,就加上Postman做接口调试,然而Postman的Mock功能比较弱,同时团队人数比较多,接口导入导出非常麻烦,且Swagger网页和Postman来回切也比较费劲,新增加接口或接口参数变更同步给其他人十分麻烦。

此时,一个好用的API管理工具会极大提高大家的工作效率,在做技术内部提效时,我们一直希望寻找到更好的API管理工具,疫情当前,我们团队很快锁定了Apipost。

Apipost官网地址:

https://www.apipost.cn

ApiPost = 接口调试+接口文档快速生成+接口文档规范化管理+Mock API+接口流程测试;即:Apipost=Swagger+Postman+Mock

Apipost恰好能解决我们现在的痛点,于是我自己进行了试用,在短短十几分钟试用后,就对它爱不释手,经过一段时间的深度使用后,发现Apipost不仅适合后端研发,前端研发,测试人员以及技术经理使用也会非常容易上手,极大提高了团队的协作效率。

以下,通过列举对比我使用过的API相关工具:

b3c63e1f58df442f8b637ba217298187.png

带你玩转Apipost

对于多年从事大型互联网老兵来说,是否是一个用心打磨过的好产品,是否好用,一上手便知;Apipost是真的香!总结如下:

不仅提供了基础的接口调试功能,而且具备文档共享贴心功能,同时,还为我们提供了更加强大的脚本录制,更是站在团队管理的角度具备非常实用的团队管理及项目管理功能,而且非常多的功能十分走心,比如:

1)业务测试场景化

一个业务线需要N个接口相互依赖,通过接口间传参完美解决;

2)利用预执行脚本发送一个请求

之前经常遇到一种场景,需要将请求结果绑定到变量,然后在当前接口的请求参数中使用这个变量。Apipost支持使用类似下面的脚本轻松实现:

apt.variables.set("token", response.json.token); // token 是接口返回字段

注:response.json是json格式的响应结果。

3)数据备份还原

再也不用担心数据丢失,以及多设备间数据共享问题;

4)响应结果分屏

在遇到大的入参请求时再也不用上拉下拉,极大提升了工作空间;

afaa3c5c927361c0cf7d70e67ec1928f.png

5)私有部署

再也不用担心数据安全,及网络问题;

还有非常多的功能,赶紧来体验解锁吧!

Web版链接(不用下载)

https://console.apipost.cn/register?utm_source=10037

客户端下载地址:

https://www.apipost.cn/download.html?utm_source=10037

Apipost实操

发送API请求

7a0dc746b66e4f4a127e43b991aea019.png
Apipost控制台

API活文档

之前经常听到抱怨:系统烂得和屎一样,文档都是错的,开发人员都换了N波了,根本没法维护!!!

敏捷开发不是不在文档上浪费太多时间吗?怎么还需要不断去写文档、更新文档?而且没人看,浪费时间!

编写文档是一件很无聊的事情!

文档不保持最新,常常会产生误导,使得大家认知更加混乱!

一线开发工作者各种吐槽文档无法实时更新,无法很好地与人共享。于是出现很多工程提效团队去做文档优化,我自己也见过很多开源的以及公司内部使用的,总体来说都在易用性上、共享等各个方面差些意思,直到遇见Apipost,完美解决了我自己遇到以及听同事反馈的所有难用的地方。

接下来为大家详细介绍下如何生成API文档以及分享给其他人。

分享API文档

a4a8f607e4cd9355b3860817e021bff8.png

打开分享连接

1bb410384c9a372c8a2b0c8b0e3c9559.png

进阶玩法-脚本

  • 脚本实现功能

    • 测试(断言)请求返回结果的正确性(后置脚本)

    • 动态修改接口请求参数,如增加接口签名参数等(前置脚本)

    • 接口请求之间传递数据(使用脚本操作变量)

    • 脚本中可以直接请求一个接口地址

  • 预执行脚本

8b2396707c836ac0e0c9fdfb2e6b6caf.png
  • 后执行脚本

e3f0a7287ec5a54b6c06cdc83e385bfa.png
  • 发送结果

267f829a8b5af390f91d87f4b5c6d24c.png

更多功能

文章篇幅有限更多好用的功能,欢迎大家亲自体验并扫码加入官方企业微信社群进行交流。

7a5e2c004ef97a441550a06b6a819d54.png

Web版链接:(不用下载)

https://console.apipost.cn/register?utm_source=10037

客户端下载地址:

https://www.apipost.cn/download.html?utm_source=10037

总结

工欲善其事必先利其器。当下是大规模合作的时代,专业的人要保证足够的精力做专业的事。既然有了Apipost这么好用且专业的工具,我们就应该快速地学习并熟练地使用它,从而大大提高我们的工作效率,完全没有必要再去花时间去自研API管理工具。

  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值