Apipost :一款值得使用的利器

Posted 2022-09-22 看，未来

文章目录

• Apipost :一款值得使用的利器
• • • 主角登场
  • Postman vs apiPost
  • swagger VS apipost
  • • swagger优点：
    • swagger的缺点
    • apipost对比：
  • 总结

Apipost :一款值得使用的利器

主角登场

    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

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的强大并不限于此，在团队管理、协同管理、项目管理的多个方面都表现的很优秀，如果你还没有用过，建议尝试一下，相信用过之后，一定会爱上！