接口管理工具YApi怎么用?颜值高、易管理、超好用

近年来,接口测试技术体系已在各大互联网企业落地普及,各种新接口框架不断涌现,业界也形成了不少成熟方案和成功案例。当前 BAT 大厂在招聘测试人员时,接口测试技能和项目经验是必考重点,直接影响到职级评定和薪资水平!
在微服务架构全面流行的背景下,接口测试能够快速并充分验证多个模块应用之间的交互(API 数据的交换、传递和控制管理过程等),可以让隐藏在代码中的底层 Bug 提前暴露,让测试能更早的发现问题,更快的作出质量反馈,促进开发在第一时间修正代码,从而让整个产品研发和测试流程更加敏捷。
互联网公司服务架构简化模拟图
接口测试的核心战略价值在于:发挥了持续集成技术和流程的作用,提高了测试效率,能高效保证系统正确性和稳定性,从而提升用户体验,并降低研发成本。因此,接口测试在持续交付体系中扮演了至关重要的角色,也是测试人必须深度掌握并好好利用的制胜法宝。
接口测试其实是一个非常庞杂的体系,可概要划分为 6 大模块 部分:

众多接口管理工具如雨后春笋搬冒出。让人欣慰的是,有许多优秀作品来自国内,包含YApi和rap。
看着中文的官网,熟悉的汉语,不禁让人暗爽。当然这也就带来另一个弊端,因为使用基数少,所以参考资料少。我们想学习使用方法,只能依赖官方文档,也算是福祸相倚了。
本文将带您走进Yapi的世界,让您体验一回小清新的接口管理工具。

根据统计,市面上互联网项目超过10亿,保守统计涉及的API数量有100亿。但是很多API的质量堪忧。因为与API相关的文档、调试、测试和数据Mock在工作中效率非常低。

我们急需一款产品,它需要具有接口管理功能,提供调试,文档管理和测试功能。这时YApi横空出世。
这是一个接口管理平台,可以帮助开发者创建、发布和维护API。YApi 还为用户提供了优秀的交互体验。开发人员只需利用平台提供的接口数据写入工具以及简单的点击操作就可以实现接口的管理。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-14DPQ7oB-1650339168599)(https://ceshiren.com/uploads/default/original/3X/5/a/5ac7c8aeb06b88d9468ab0a989e0d9ac9fe368f0.jpeg)]

YApi适合公司业务比较复杂,尤其是跨部门协作的情况下使用,和它类似的工具还有rap、swagger、moco。

rap也具有图形界面,但火爆程度逐渐不如yapi。而swagger呢,是一个超级强大的工具,它的野心已经不满足于接口管理,后续课程会讲到它。

moco在13年获取Duke选择奖,moco的使用也很简单,维护一份json文件,然后利用命令运行。

在这么多工具面前,YApi能够脱颖而出实属不易。在实际工作中,YApi和swagger属于两个流派,前者易于管理,有着友好的UI界面,但生态弱,依赖人工和UI维护。而swagger呢,是一个十足的野心家,已经提供api全生命周期的解决方案,它已经不是工具,已然成为了标准。

进入YApi后,这页面,这UI,确实小清新,不愧是后起之秀。这里简单进行介绍,它主要有下面四个部分:
1.首页头部展示了当前所在的位置、搜索框、新建项目、查看文档和用户信息。
2.首页左侧展示分组信息,“分组”是“项目”的集合,只有超级管理员可以管理分组。
3.首页右侧是分组下的项目和成员列表,点击左侧的某个分组,右侧会出现该分组下的项目和成员信息。
4.点击项目右上角的星星即可关注项目,关注的项目可以在“我的关注”页面查看。

其实不光是首页UI,他的项目UI也令人咋舌,在UI上这么清新的国内平台已经非常少见。

点击一个项目,进入项目页,项目页展示了属于该项目的全部接口。并提供项目、接口的全部操作。
5.项目页左侧的 “接口列表” 展示了该项目下的所有接口,右侧默认显示该项目下所有接口的列表。
6.点击左侧的某个接口,右侧会出现“预览”、“编辑”和“运行”。
7.点击左侧的 “测试集合” 使用测试集功能。
8.点击二级导航的“设置”,项目组长即可编辑项目信息和管理成员列表。
9.点击二级导航的“动态”,即可查看项目的操作日志。

有的读者已经迫不及待了!下面用一个简单例子来入门YApi,在项目里新建接口,这时会弹出一个窗口,几个选项都很清楚,接口路径是什么?这是方便前端调用后端,而设置的接口路径:


点击新添加的接口,右侧可以看到接口的预览信息,点击右侧的编辑进入编辑面板。在该面板中你可以看到接口的基本信息(接口名称、分类、路径),除此以外,你还可以完善以下接口信息:

  • 接口路径:可以更改 HTTP 请求方式,并且支持 restful 动态路由,例如 /api/{id}/{name}, id和name是动态参数
    • 状态:用于标识接口是否开发完成。
    • Tag:用于标识接口tag信息(v1.3.23+),在接口list页可以根据tag过滤接口
  • 我们接着往下看,你会看到请求参数,可以设置请求时需要哪些参数,它们可以是必需,也可以是不必须:
    • Query参数:接口 url 的查询字符串。点击『添加Query参数』按钮来添加参数,可以通过拖动来交换参数位置
    • Headers:http 请求头字段。在 req_body 形式是 form 格式下会在 header 中自动生成 ‘Content-Type application/x-www-form-urlencoded’,其他3种格式也会自动生成不同 header
  • 请求参数后面是返回数据,它分为 json & raw 两种形式。基于 mockjs 和 json5,这是一种使用注释的方式写参数说明,如果你看不懂,请注意下面的链接,这是官网对Mock的介绍。
  • Mock介绍:
  • https://hellosean1025.github.io/yapi/documents/mock.html
  • 上面只是对接口的设置,但我们经常遇到一些情况,比如我想根据不同的请求参数、IP返回不同的 HTTP Code、HTTP 头和 JSON 数据,这么复杂的情况,接口设置是无法做到的,期望Mock登场!它说:“你们靠边站,我可以做到!”
    期望Mock可以根据设置的请求过滤规则,返回期望数据,这是一个高端玩家。要想使用它,你要先进入接口详情页,然后点击高级Mock。

    点击添加期望,填写过滤规则以及期望返回数据,如下图这样,最后点击确定。


我们在浏览器里测试一下,发送符合规则的请求:

就像文中说的那样,在这么多工具面前,YApi能够脱颖而出实属不易。在实际工作中,YApi和swagger属于两个流派。前者易于管理,有着友好的UI界面,但生态弱,依赖人工和UI维护。而swagger呢,是一个十足的野心家,已经提供api全生命周期的解决方案,它已经不是工具,已然成为了标准。
YApi要走的路还很长,它有自己劲敌:swagger。由于篇幅有限,本篇文章暂时讲解到此,更多精彩内容请关注霍格沃兹测试学院公众号。

更多技术文章分享

  • 接口测试技术基础知识
    • 接口测试用例的编写与管理
    • 接口测试的运行与维护
    • 接口测试的监控与分析
    • 接口测试框架实现与项目实战
    • 持续集成/持续交付体系知识
  • 在落地接口测试过程中,不仅会涉及到很多技术细节,比如前置测试数据的准备和自动清理,常见接口协议的实现和封装、依赖注入配置方式的支持、文件/图片/XML/字符等各类通用处理方法的集成以及断言等等,还需要结合业务特性不断动态演进。这给很多缺乏经验的测试同学带来不小的学习挑战,在技术面试时也经常被各种提问卡住。
  • 为帮助大家高效掌握接口测试技能,霍格沃兹测试学院特意推出一门超级强大、无比暖心的精品课程 ——《接口测试项目实战与面试题解析》训练营 ,提炼了 BAT 大厂接口测试技术栈中最核心通用的重点技能,并通过实战项目演练,带领大家一一通关,快速突破!
  • 【实战训练】:不光有接口测试核心知识点/最流行工具的深度解读,更带你手把手实操演练,全程 1V1 打卡督学,并由大咖讲师认真点评作业成果和结业考试。我们还为优秀的同学准备了千元现金红包激励!
  • 【你将得到】:从 0 构建接口测试完整体系 + 2 大接口测试必会利器 + 5 大项目实战演练 + 10 年资深测试架构师实践心得 + 经典面试题解析。
  • 【限时特惠】:原价299元,限时特惠价0.02元!!对,你没看错,这其实是一门公益福利课程,旨在推动先进接口测试技术在业界的普及。抓紧报名,开启你的接口测试进阶之旅!
  • 欢迎转发给更多测试小伙伴!
  • 点一下好看,少一个 Bug ⬇️
  • 原文链接
    更多技术文章分享

猜你喜欢

转载自blog.csdn.net/hogwarts_2022/article/details/124269671