文章目录
- Apipost :一款值得使用的利器
- 主角登场
- Postman vs apiPost
- swagger VS apipost
- swagger优点:
- swagger的缺点
- apipost对比:
- 总结
Apipost :一款值得使用的利器
主角登场
代码语言:javascript复制 Apipost 是一个支持模拟POST、GET、PUT常见的HTTP请求,支持团队协作,并可直接生成并导出接口文档的API调试、管理工具。
你可以把这款利器看成这样的组合:
Apipost = Postman Swagger Mock
Postman和Swagger大家应该都很熟悉了吧,Mock这边小编和大家简单介绍一下,Mock其实就是模拟接口所返回参数的工具,方便快速帮助走完整体流程,在一些特殊的环境下,可以帮助我们进行程序调试。举个例子,A公司和B公司,有合作关系,现在项目都已经上线了。然后B公司把他们的测试环境关闭了,但是A公司可能他内部需求调整需要使用B公司的测试环境来进行走程序流程。这个时候该怎么办呢? Mock就是一个很好的方式,A公司可以在Mock工具里定义B公司程序所返回的结果,这样由之前调用B公司的测试地址,改成为调用Mock测试地址,从而达到模拟的效果,而今天推荐的Apipost就提供了Mock工具,详细点小编在后面为大家详细的讲解。
整体上,我们认识Apipost它所具备的基本能力,那为什么小编要给大家推荐这款?
小编公司刚好Postman、Swagger、Mock三个功能都有使用,三个功能,对应着三个产品,接口调试小编需要下载Postman、使用Swagger对代码有侵入性,而且Swagger最后显示出来文档效果着实不咋地、使用Mock需要额外去下载一个Mock工具,进行私有化部署,占用服务器资源、域名资源等等。
Apipost 就把这三点集中于一身,低成本做长期主义的事情,小编就分着三个维度,给大家讲讲Apipost它和其他产品对比的一个优势。
Postman vs apiPost
代码语言:javascript复制Postman
简介 Postman是Google开发的一款接口测试工具,提供功能强大的 Web API & HTTP 请求调试。它能够发送任何类型的HTTP 请求 (GET, HEAD, POST, PUT…),附带任何数量的参数 headers支持不同的认证机制(basic, digest, OAuth),接收到的响应语法高亮(HTML,JSON或XML)。Postman 能够保留了历史的请求,这样我们就可以很容易地重新发送请求,有一个“集合”功能,用于存储所有请求相同的API/域
apipost
简介 apiPost是一个支持团队协作,并可直接生成文档的API调试、管理工具
支持模拟POST、GET、PUT等常见请求,是一个国产的、跟Postman差不多的、用来测试Web API的软件,提供window、mac、linux版本下载,对于有在开发Web API的开发者相当有用,同时由于它是国产软件,完全中文界面更加友好,也符合中国开发者的使用体验。另外支持一键生成api接口文档,省掉不少开发者的工作
swagger VS apipost
swagger优点:
- 一个文件就是一个文档
- 只针对API,而不针对特定的语言的API,很多自动生成API的工具基本都是只针对特定的API的
- 官网有直接的demo,甚至都可以不用自己搞一套服务器
swagger的缺点
代码侵入性太强、项目中需要依赖与业务无关的jar包、需要编写大量与业务无关的注解和参数,增加开发成本,降低代码可读性 文档的展示依赖于项目的部署启动。不便于前端脱离后端进行接口调试,降低开发效率 不支持全局的接口文档的统一管理和维护,没有一个文档中心 不支持mock数据,不便于前端调试复杂接口,影响前端开发效率及质量 不支持权限管理,对于接口文档的访问没有项目、角色、人员级别的权限管控 不支持测试人员进行接口自动化测试 不支持导出备份 添加文档备注很不方便,需要更改源代码,不能添加截图备注/不适合添加大段的备注等 对于返回结果不能添加说明或者实现这个功能非常麻烦。虽然 Swagger 有 @ApiResponse 注解用来说明返回结果,但是这个使用并不方便,而且如果返回的并不是对象的时候(如 Map),就无法实现给每一个返回字段的说明。如果将所有的返回结果都是用对象封装,然后添加注解,这又是一个非常大的工作量
apipost对比:
一键快速生成文档:接口文档的撰写非常麻烦,很多属于重复工作,效率低下。接口参数填写完毕后,只要在 Apipost 按下“分享文档”按钮,就会一键自动生成漂亮、规范的文档,并且可以自定义分享有效期及权限。
团队成员间可实时协作:针对团队成员间协作不同步,数据保存有冲突,无法追溯变更记录的情况,多人在线协作时,Apipost 支持数据实时同步,有冲突解决机制,并且可以追溯协作日志。 客户端支持不登录使用:用户处于局域网环境时(或者公司对网络限制严格),Apipost 客户端支持不登录使用。 客户端支持离线脱机使用:即使在拔掉网线的情况下,仍可以正常打开 Apipost 客户端的进行大部分操作。 参数库描述:很多接口往往具有大量相同名称、相同意义的参数,每次手动重复录入,非常耗时、低效。Apipost 通过自定义参数描述库,可以将大量参数进行预注释,并在输入参数时支持自动填充描述,节省了我们不少重复录入参数描述的时间。 Websocket测试功能:另外,全新Apipost6.1版本重点推出用户屡次提到的Websocket测试功能。
同时apipost中仍可以使用mock中的功能,真可谓之完美。
总结
至此,通过对比我们不难发现apipost是一款具有强大功能的一体化协作性工具,但ApiPost的强大并不限于此,在团队管理、协同管理、项目管理的多个方面都表现的很优秀,如果你还没有用过,建议尝试一下,相信用过之后,一定会爱上!