当前位置: 首页 > Web前端 > HTML

Postman大势已去

时间:2023-03-28 11:00:29 HTML

作为前端,在日常开发过程中除了编写业务代码外,前后端联调是重要的一环。但是这个环节往往是整个开发过程中最繁琐、最累人的环节。大家都想早点下班,但是提高联调效率并不是一个单纯的技术问题,而是需要一个好的工作流程的问题。友情提示:(前面的介绍只需要1分钟,干货部分5分钟左右)前面的介绍:个人经验摘录代码:403在公司切换技术栈的时候把我踢走了中台系统,以半个sprint为周期为单位进行业务模块的迁移。各业务模块验证上线后,“老爷车”相应部分将下架,并通知员工基于新中台系统开展工作。当时恰逢数据库扩容和分库分表,偶尔出现的接口流故障给日常开发增添了麻烦。在此背景下,我负责FeedbackandSuggestion模块的迁移,即大量类型、状态、Tag、Progress和统计数据可视化PieChart的呈现。我巧妙地使用了AntdProtable和AntV,结合Swagger文档,2个小时定义了各种栏目,满怀期待的在控制台进入yarndev登录系统,选择子系统,进入页面。页面正常,控制台不红,唯一不足的是数据小于10条。无法验证Pagination和PieChart。这时候坐在我对面的后端小哥说DEV数据少,你去UAT吧。为了让产品经理在验收的时候能够看到各种数据的展示。一番操作后,尴尬的事情发生了。成功进入系统后,点开页面就被踢了出去。一瞬间,我的脑袋嗡嗡作响。思考有以下一种可能:跨域|后台角色权限未配置|请求路径错误|请求方法错误|认证失败后台小哥的语录:“我这里可以,再试一次?”“你是不是令牌已经过期了。”“Sendmetherawrequest”“Sendmeyouraccountnumber”最后发现后台小哥还没有把对应的分支推上去。大眼睛的Swagger欺骗我记录整数,实际的字符串。0|1|2代表状态,某个需求去掉2,还剩下0|1,但是在业务逻辑上,0代表1,1代表2,多年来,潜规则就是犯错。数据库里的数据用了很久,标志混杂却没有注释,新人摸不着头脑。接口路径/数据结构不一致/未实现,根据文档编写解析代码后,发现结构不正确或缺少字段。简而言之,各种文档错误/文档已过时。根据复杂性守恒原理,是否有更好的解决方案?最好是鼠标点击级别的那种。工改版回答“永远不要相信前端传来的参数”和“永远不要相信后端接口”都说得很烂,就像ARMS的警报不时让人紧张一样。抛开各种不可预测的事情,能否从我们能控制的事情做起?比如保证文档的“一致性”和“及时性”,也许这不应该成为问题,但我相信工作多年的程序员都是人,什么都明白。然而我们是程序员!我们用别人的工具!为什么选择Apifox一个优秀的产品应该符合用户的直觉。当用户想着是否有某项功能(非一般业务场景)但恰好提供了,一定会赢得用户的好感。Apifox就是这样一个优秀的效率提升工具。Apifox是API文档、API调试、APIMock和API自动化测试的集成协作平台。节省您研发团队的每一分钟!下面简单介绍一下使用Apifox的开发流程设计接口的零配置Mock服务。前端开发者可以基于Mock服务进行开发。后端实现这个接口。最难能可贵的是,项目中的界面是同步更改的,界面文档也是自动生成的,完全不侵入代码。这意味着开发人员不会有我曾经有过的挫败感。至此,一个能够成功请求并保证项目中文档同步和数据结构同步的Mock接口的简单愿望已经满足。后期的任何改动也变得轻松高效,只需轻点鼠标。横向比较Postman,常用的功能和使用习惯是一致的,并且做了很多创新,提高了开发者的效率。1.接口支持“用例管理”。通常,一个接口有多个用例,例如正确用例、参数错误用例、空数据用例和不同数据状态用例。在定义接口的时候,定义好这些不同状态的用例,调试接口的时候直接运行,效率很高。2、“数据模型”的定义和引用可以独立定义数据模型,接口定义可以直接引用数据模型,数据模型之间也可以相互引用。同一个数据结构只需要定义一次,就可以在多个地方使用;修改时只需修改一处,多处实时更新,避免不一致。3、调试时“自动校验”数据结构使用Apifox调试接口时,系统会根据接口文档中的定义,自动校验返回的数据结构是否正确。无需肉眼识别,无需手动编写断言脚本进行检测。非常有效率!Apifox自动校验数据结构4.“可视化”设置断言设置断言:Apifox设置断言运行后,查看断言结果:5.“可视化”设置提取变量6.支持数据库操作7.“零配置”Mock是非常人性化先放一张数据图,对比一下Apifox和其他同类工具与零配置mock的数据效果:ApifoxMock数据结果与同类工具对比。可以看出,Apifox零配置mock生成的数据非常接近真实情况。前端开发可以直接使用,无需手动编写mock规则。Apifox如何做到高效零配置生成非常人性化的mock数据Apifox根据接口定义中的数据结构和数据类型自动生成mock规则。Apifox内置智能mock规则库,根据字段名和字段数据类型智能优化自动生成的mock规则。例如:名称中包含字符串image的字符串类型字段自动模拟一个图片地址URL;包含字符串时间的字符串类型字段自动模拟一个时间字符串;包含字符串city的字符串类型字段会自动模拟一个城市名称。Apifox可以根据内置规则,自动识别图片、头像、用户名、手机号、网址、日期、时间、时间戳、邮箱、省市、地址、IP等字段,从而mock出非常人性化的数据。除了内置的mock规则,用户还可以自定义规则库,满足各种个性化需求。支持使用正则表达式和通配符来匹配字段名称的自定义模拟规则。8、生成在线接口文档Apifox项目可以在线“分享”API文档。共享的API文档可以设置为公开或需要密码访问,非常方便与外部团队协作。体验地址9.代码自动生成根据接口模型定义,各种语言/框架(如TypeScript、Java、Go、Swift、ObjectiveC、Kotlin、Dart、C++、C#、Rust)的业务代码(如Model、Controller)等)自动生成,单元测试代码等)和接口请求代码。目前Apifox支持130种语言和框架的自动代码生成。更重要的是:您可以通过自定义代码模板来生成符合您团队架构规范的代码,以满足各种个性化需求。10、导入导出支持导出OpenApi(Swagger)、Markdown、Html等数据格式。因为可以导出OpenApi格式的数据,所以可以使用OpenApi(Swagger)丰富的生态工具来完成各种接口相关的事情。支持导入OpenApi(Swagger)、Postman、HAR、RAML、RAP2、YApi、Eolinker、NEI、DOClever、ApiPost、Apizza、ShowDoc、APIBlueprint、I/ODocs、WADL、GoogleDiscovery等数据格式,方便迁移旧项目。当你第一次登录时,Apifox会默认提供一个样例工程供你体验,就像看到APIHub,就知道以后的开发项目调用第三方API会有多方便。限于篇幅写在最后,不能再多介绍了。希望有兴趣的朋友可以去Apifox官网亲自体验一下。熟悉的VUE风格,爱你。聪明的程序员必须知道如何提高开发效率,从而保证产出。下班抽时间做饭,提高自己的技术!与你分享!