1. Apipost是什么
Apipost = 接口调试+接口文档快速生成+接口文档规范化管理+Mock API+接口流程测试。 Apipost产生的初衷是为了提高研发团队各个角色的效率!产品的使用受众为由前端开发、后端开发和测试人员以及技术经理组成的整个研发技术团队。 Apipost通过协作功能将研发团队的每个角色整合打通。
2.为什么选择Apipost
对于后端人员来说Apipost不仅仅是一个接口联调工具,更是一个接口文档快速生成工具。在编写、测试接口的同时快速的、自动的生成漂亮、规范的接口文档。同时还能够生成Mock数据、生成程序代码 。 对于前端人员来说不仅提供了体验良好的接口文档浏览页面,还提供了接口数据 Mock、前端代码自动生成等功能。 对于测试人员与研发经理来说,Apipost提供了接口自动化测试、规范接口文档管理等强大功能。
3.产品优势与特点
Apipost官网地址:https://www.apipost.cn?token=a5112be0d08cb20ba5ec66cc8d13aba6 Web版地址:https://console.apipost.cn/register?token=a5112be0d08cb20ba5ec66cc8d13aba6 客户端下载链接:https://www.apipost.cn/download.html?token=a5112be0d08cb20ba5ec66cc8d13aba6 在日常工作中,一个良好的联调工具应该具有操作简单,易上手,美观良好的ui,协作,归档,团队管理隔离等功能,而Apipost全部都具备。本文我们使用postman不具备的Web版本,向大家展示这些功能。
3.1 联调接口简洁方便
作为联调工具基本功能,Apipost提供了一个用户体验非常良好的界面,且操作一目了然,更容易上手与使用。选择APIs选项,并填写请求头、请求体、认证等请求接口必备信息即可完成。如下图事例。 通过成功响应事例提取出参数。
3.2 一键生成接口文档
在日常工作中,如果与前端人员联调接口,那么需要提供完整且美观的接口文档,通常选择swagger作为文档工具,但是这里我们面临这文档耦合度高,编写较为困难等问题。而Apipost提供了一键生成文档功能,选择分享文档,并复制链接到web上,即可查看接口文档。 可以看到接口文档样式比swagger样式清爽了不少,且大量减少在代码中的文档编写。
3.3 设置全局参数
在日常接口联调过程中,需要频繁变换参数,如token等全局参数,在参数过期后,如果每一个接口都需要修改这无疑是一个不明智的选择,这个Apipost可以设置全局参数,减少在调试过程中频繁的变换参数。
3.4 文档归档
提供完接口文档后,有个问题,如果文档被前端人员误改而造成工作失误从而背锅这岂不是很难受,而开发人员已经为我们选择好解决方案。Apipost提供了归档功能,此文档一旦被归档,那么前端展示的文档就是归档那个时刻的文档快照,不会随着客户端的临时修改导致的接口保存而改变。未归档的情况下,文档页面仍是实时文档。防止在共享时随意更改接口文档。
3.5 自动生成代码
当在联调测试之后,我们想在linux或java中调用,此时我们并没有api工具,就需要我们编写代码测试。通常需要百度出语法然后按照语法编写,而Apipost提供了大量的语言语法,填写完接口请求参数后您就可以生成程序代码。 提供多达10多种语言以及各种SDK的HTTP请求代码,代码可以非常快速的集成到您的代码中。
3.6 相互协作
同时针对于体量较大的团队,也提供了线上协作功能,同时针对团队成员间协作不同步,数据保存有冲突,无法追溯变更记录的情况,多人在线协作时,Apipost支持数据实时同步,有冲突解决机制,并且可以追溯协作日志。
3.7 团队管理
在日常开发中,大体量的团队最困难的就是管理,如何查看工作量,如果分配角色权限,如何协调人员都是管理者应该关心的。而Apipost提供团队管理功能,设计的初衷是为了便于人员流动,您可以把它一个公司理解为一个团队。当人员离职或者更换公司时,可以通过新建团队和切换团队来实现不同公司间项目数据的隔离。 针对每一个注册的账号,Apipost会分配一个系统默认创建的团队。您也可以通过点击左侧的“团队”标签,找到“新建团队”按钮新建一个团队。 同时也提供了新建项目、项目克隆、项目导入/导出、维护项目人员/协助人员、维护项目人员/协助权限。实现了一站话的项目管控与管理。
3.8 免费使用
15人以下的团队和个人完全免费,针对高校和培训机构也是完全免费的,企业也可以根据需要进行私有化部署。
4.总结
在博主使用中,Apipost提供了良好ui,简易的使用方式,同时可以在web端使用,随用随上。协作,一键生成文档也节约了大量沟通上花费的时间。而归档功能也避免了前后端扯皮的情况。现Apipost已经被推广到我司。该软件值得学习与在工作中使用。
|