揭开Apifox的神秘面纱
曾经在对于接口管理和调试工作上,大量的开发者往往会选择使用Swagger做接口文档管理,用Postman做接口调试工具,然而这样使用的痛处其实也不言而喻,原本同一类型的工作却被放置在不同的软件工具上,并且对于接口调试中的复杂操作和数据请求,很多接口调试工具往往不能满足。
然而现在很多国产的接口调试工具已经不同往昔,诸如我们今天要介绍的—Apifox,Apifox是集API文档、API调试、API Mock、API自动化测试为一体的协作平台,它将我们日常使用的Postman Swagger Mock JMeter进行集成、解决了这些软件之间数据同步的问题。并且为了最大程度上提高开发人员的便捷性,Apifox支持只要定义好API文档,那么API调试、API 数据 Mock、API 自动化测试就可以直接使用,无需再次定义,有效提高软件开发效率,是一个名副其实的高效综合型接口协作工具。
Apifox能够充分的定位到中国开发者的日常开发习惯,从开发者的日常使用、协作、文档编写、协作开发、前后端联调等方方面面入手,以解决中国开发者使用痛处、提高开发效率为目的,将Apifox工具迭代得更加的神通广大,接下来我和大家介绍一下它的过人之处!
神通广大的Apifox
一、丰富多样的接口设计方案
接口设计与运行解耦
Apifox对于接口设计可谓是别出心裁,在工具中提供了多种多样的接口调试和参数管理方式,与其他接口调试工具不同的是,Apifox区分接口设计和接口运行的概念,将接口的设计与运行分离,使两者完全解耦。
在接口设计中,需要开发者对所用接口的规范及使用说明进行定义,方便其他人员进行查看,在真正运行接口的路由地址则定义在接口运行中,并且支持区分不同场景下的接口使用。
请求前置与后置操作
在日常使用过程中,我们往往希望在接口请求之前后之后进行一些操作,来对我们的接口中的数据进行校验或其他特殊处理,但是呢这样的操作往往都需要写在我们的代码中去,并不能将其提取出来进行调试。
但是Apifox就完美的支持了这个功能,在工具中我们可以对请求的接口设置前置和后置操作,诸如变量信息的提取,请求前的数据校验、返回后的数据库操作等内容。
二、便捷高效的团队协作管理
很多的接口管理和调试工具都是单机版本的,不支持团队成员的实时协作开发。但是在这个团队为王的时代,项目的开发离不开团队成员之间的协作,因此很多时候我们的接口调试都是需要团队成员共用并且协同开发的。这种情况下,就需要我们的管理工具能够对团队管理具有强大的支持!
Apifox针对这一痛点,提供了团队成员协作和团队成员权限管理,对于不同的使用成员可以进行不同的权限划分,有效的将测试、产品、前后端开发工程师的不同权限进行分离,确保不同的人员都能够安全的对项目接口进行操作,避免不同人员之间引起一些操作问题发生。
Apifox支持团队权限和成员权限管理,在团队权限中你可以对整个团队的状态进行管理,诸如:团队信息修改、移交和解散团队、修改成员信息等,这里就相当于是项目经理的功能。在项目权限(成员权限)中,工具支持对项目中接口的不同操作权限划分,诸如接口文档的访问权、接口编辑和查看权、数据模型修改和测试套件运行等。
三、支持多种文件的导入导出
之前在使用其他调试工具的时候就有非常大的感触,对于不同类型的文件想要集成到项目中去是十分不方便的,而且很多的调试工具不支持诸如markdown等接口文档的导出。
多样化的文件导入解析
在这一点上我觉得Apifox是非常有特色的,在文件导入上,Apifox支持OpenApi (原Swagger)、Postman、HAR、RAML、RAP2、JMeter、YApi、Eolinker、NEI、DOClever、ApiPost 、Apizza 、DOCWAY、ShowDoc、apiDoc、I/O Docs、WADL、Google Discovery等数据格式,方便我们之前旧项目的迁移。
而且在数据导入之后,支持之前的接口覆盖与修改,接口分组划分,及时具有导入抓包数据的需求,Apifox仍然能够支持!是不是很nice?
接口文档输出类型丰富
因为有一些特殊情况需要我们对内嵌在工具中的接口文档进行导出查看,这个时候就需要支持接口文档生成本地文件,对此Apifox支持直接导出OpenAPI (原Swagger)、HTML、Markdown、Apifox等数据格式。而且导出的文档排版十分的简洁美观!
下面是我导出的HTML格式的接口文档:
四、方便快捷的文档发布策略
快速发布在线文档
在日常进行接口沟通、评审的工作中呢,我们一般不会直接拿Apifox工具来进行项目接口的讲解和评审工作,而且需要生成能够共享的在线文档,并且这种共享文档相对于本地的ward、markdown等文档不需要来回发送,就算存在一些内容的修改,我们也只需要重新分布,其他用户便可以实时的查看更新,这样就可以非常有效的提高工作效率。
并且在发布在线文档的时候,Apifox支持设置文档语言、访问密码、过期时间、分享范围等信息,
通过生成的连接,可以直接访问生成的在线文档。
在线文档直接调试
Apifox更具特色的一点就是它的在线文档支持直接在线请求接口进行调试,不需要我们再打开Apifox工具进行接口请求。就可以直接在在线文档中查看返回数据信息。
五、效率倍增的Mock功能
平常我们在做前后端分离的项目开发时,前端的同事往往需要等后端的接口完成之后才能进行对应功能的调试,因此Apifox就针对这个问题还提供了强大的Mock功能,在这个功能的依托下,前后端的开发人员可以同步的进行到开发流程中,并且前端人员可以利用Apifox的Mock功能设计假数据进行功能的调试。
六、持续集成的多样化自动测试
平常我们在进行接口测试的时候往往为了最大程度上的模拟真实场景,会考虑如何对多个接口进行同时请求响应,实现并行请求从而完成一个完整的业务操作。
在Apifox中就具备这样强大的功能支持,在Apifox的自动化测试界面,我们可以对要进行自动化测试的接口进行设置和分组,在启动之后,多个接口就可以同时的对接口进行请求响应。
除此之外,Apifox还支持测试套件和测试数据的定义,之后当用例或测试套件运行时,系统就可以循环运行数据文件里所有的数据集,并且会将数据集里的数据赋值给对应的变量。达到最真实的效果!
不断创新与迭代中的Apifox
上面只是我和大家介绍了关于Apifox的一些特色功能,除此之外Apifox团队仍然在不断的以开发者的角度去解决问题、以高效、及时、准确为目的服务于广大的开发者朋友,在日常开发中使用Apifox进行接口调试最大的一个感受就是高效,它能够将原本繁琐的工作最大程度上的进行化简,有效的提高工作效率。
并且除桌面版以外,Apifox还提供了网页版的接口调试工具,让你的调试工作不再局限于本地。网页版地址