前言
- 降本增效一直是企业不断追求不断提高的目标;
- 随着微服务成为各种互联网的标准配置,人们在享受微服务带来的便利的同时,也引入了一些痛点。例如,一个项目可能需要数十个或数百个应用程序的合作,其中可能涉及数百个API;
- API管理逐渐成为开发、联调、测试中的痛点;此时,它很容易使用API管理工具必然会大大提高每个人的工作效率;在提高技术内部效率之前,我一直在寻找更好的方法API工具路上;
痛点&解法&管理&玩转
API痛点的研发和联调时
总结一下我们团队之前的情况API痛点问题:
- 多个开发团队使用API工具(Yapi,Swagger,Postman,自主研究等多个工具之间的数据难以打开;
- API文档编写繁琐、设计不规范、缺乏统一文档格式等;
- 缺乏版本管理,API变更未通知;
- 测试人员难以维护测试用例,大量使用脚本编写自动化测试,学习、编写和维护成本很高
Apipost如何解痛点
- DTDD(文档和测试驱动开发)
- 形成标准文(开发、测试、运维)合作的标准文件
- 通过测试结果,促进项目进度,团队沟通更加顺畅,项目管理可量化
API管理之路
-
起初在用Swagger接口管理,但发现调式功能很弱
-
后来就加上Postman接口调试,Postman的Mock功能弱,团队数量多,接口来回导入很麻烦;而且Swagger网页和Postman来回切也比较费力;新增界面或界面参数的同步变化对他人来说非常麻烦;
-
一直在寻找更好的API管理工具;皇帝不回报,在一次偶然的浏览中看到了它Apipost,通过其官网**https://www.apipost.cn?token=171e2f70f67756057b69b64aae3b41f3** 了解到 即 ;
-
Apipost这可以解决我们目前的痛点,所以我自己尝试了,仅仅十分钟后,我喜欢它;经过一段时间的深度使用,我发现不仅后端研发,而且测试人员和技术经理非常实用,可以大大提高团队合作效率;
-
以下是我用过的API对比相关工具
Swagger | 实时 | 弱 | 弱 | 不支持 | 不支持 | 不支持 | 实时在线 | 无 |
Postman | 无 | 强 | 弱 | Beta版 | 只支持导入 | 不支持 | 需要来回分享麻烦 | 无 |
Yapi | 手工录入 | 较弱 | 弱 | 不支持 | 支持导入 swagger, postman, har 数据格式 | 不支持 | 实时在线 | 有 |
Apipost | 支持在线接口文档共享 | 强 | 强 | 6.1版及以上支持 | 支持多文件格式导入 | ApiPost支持生成NodeJS、Ajax等常见前端程序同时提供后端主流语言代码自动生成功能 | 实时在线支持多人实时合作 | 有 |
带你玩转Apipost
真香
还有很多功能,赶紧解锁:
- Web版本链接(无需下载)
- 客户下载地址:
发送API请求
- api请求
- api响应
API活文档
-
我以前经常听到这种抱怨
- 系统烂得像屎,文档错了,开发人员换了N波,根本维护不了!
- 敏捷开发不是不在文档上浪费太多时间吗?为什么还需要不断写文档更新文档,没人看,浪费时间!
- 写文档很无聊!
- 文档不保持最新,往往会产生误导,使大家的认知更加混乱! …
- 一线开发人员对各种文档提出投诉,不能实时更新,不能很好地与他人分享;因此,有许多项目提高效率的团队进行文档优化。我自己也见过很多开源和公司内部使用。一般来说,它们在易用性、共享和其他方面几乎有意义;直到你见面Apipost,完美解决我遇到和听同事反馈的所有困难;接下来,我将详细介绍如何生成它API与他人分享文档和文档
-
分享API文档
-
打开共享连接
高级玩法-脚本
-
脚本实现功能
- 测试(断言)要求返回结果的正确性(后脚本)
- 动态修改接口请求参数,如增加接口签名参数(前脚本)
- 在接口请求之间传递数据(使用脚本操作变量)
- 脚本可以直接要求接口地址
-
预执行脚本
-
后执行脚本
-
发送结果
更多功能
文章篇幅有限更多好用的功能,欢迎大家自己体验并在评论区交流
- Web版链接(不用下载)
- 客户端下载地址:
总结
- 工欲善其事必先利其器
- 现在是大规模合作的年代,专业的人做专业的事;有了Apipost这么好用专业工具我们应该快速学习熟练使用它,大大提高我们的生产效率,没必要再去花时间再去自研API管理工具