友情提示:(阅读前情简介仅需1分钟,干货部分大约5分钟) 前情简介:亲身经历节选Code: 403 将我踢飞彼时正处公司切换中台系统的技术栈,以半个sprint周期为单位进行着业务模块的迁移。每一个业务模块验证上线后就会下架 老爷车 中相对应的部分并通知员工基于新的中台系统进行办公。彼时又恰逢数据库扩容和分库分表,接口流转偶有故障为日常开发增添了麻烦。在这个背景下,我当时负责 反馈建议 模块的迁移,也就是非常多的 type,status 以 我潇洒的使用 yarn dev 登录系统,选择子系统,进入页面。 页面正常,控制台没有红色,唯一不足就是数据少于10条。无法验证 分页 和 为了让产品经理验收时能看到各种数据的展现。 一番操作,尴尬的事情出现了,成功进入系统后却在点击页面时被踢了出来。 一瞬间,脑袋嗡嗡。 思考着以下可能之一 :跨域| 后台角色权限没配置| 请求路径错误 | 请求方法错误 | 鉴权失败 后端小哥语录 :
最后的最后,原来后端小哥还没把 对应分支 推上去。 浓眉大眼的 Swagger 把我欺骗
根据复杂度守恒原理,有没有更好的解决办法呢?最好是那种 鼠标点点 级别的。 工作提效的版本答案"永远不要相信前端传过来的参数" 和 "永远不要相信后端的接口" 都被说烂了,就如同 ARMS 的警报 不时让人精神紧绷。 抛开各种无法预料的事情,我们能否先从能掌控的事情下手? 譬如保证文档的 一致性 和 时效性 ,或许这本不该是个问题,但相信工作多年的程序员都 人之常情,懂的都懂。 然而 我们是程序员!我们使用 别人的 工具! 为什么是Apifox一款优秀的产品应该符合用户的直觉,当用户某次思考是否有某个功能(非一般业务场景)却又恰好被提供的时候,绝对很能赢得用户的青睐。Apifox便是这么一款优秀的提效工具。 Apifox是 API 文档、API 调试、API Mock、API 自动化测试一体化协作平台。 节省研发团队的每一分钟! 先简单说明使用Apifox的开发流程
最值得称道的是,项目内接口是同步更改的,接口文档也是自动生成,完全不入侵代码。这就意味着开发人员不会再遇见我曾经的郁闷。至此,已经满足了一个项目内可以成功请求并保证 文档同步 和 数据结构同步 的Mock接口的朴素愿望。后期任何改动亦变得轻松高效,简直 鼠标点点 。 横向对比Postman,常见功能和使用习惯保持了一致,还做了非常多的创新,来提升开发人员的效率。 1、接口支持“用例管理” 通常一个接口会有多种情况用例,比如 2、“数据模型”定义、引用 可以独立定义数据模型,接口定义时可以直接引用数据模型,数据模型之间也可以相互引用。同样的数据结构,只需要定义一次即可多处使用;修改的时候只需要修改一处,多处实时更新,避免不一致。 3、调试时“自动校验”数据结构 使用 Apifox 调试接口的时候,系统会根据接口文档里的定义,自动校验返回的数据结构是否正确,无需通过肉眼识别,也无需手动写断言脚本检测,非常高效! Apifox 自动校验数据结构 4、“可视化”设置断言 设置断言: Apifox 设置断言 运行后,查看断言结果: 5、“可视化”设置提取变量 6、支持数据库操作 7、“零配置”Mock 出非常人性化的数据 先放一张图对比下 Apifox 和其他同类工具 Apifox Mock 数据结果对比同类工具 可以看出 Apifox Apifox 如何做到
8、生成在线接口文档 Apifox 项目可“在线分享” API 文档,分享出去的 API 文档可设置为公开或需要密码访问,非常方便与外部团队协作。 9、代码自动生成 根据接口模型定义,自动生成各种语言/框架(如 TypeScript、Java、Go、Swift、ObjectiveC、Kotlin、Dart、C++、C#、Rust 等)的业务代码(如 Model、Controller、单元测试代码等)和接口请求代码。目前 Apifox 支持 130 种语言及框架的代码自动生成。 更重要的是:你可以通过 10、导入、导出
贴心为你初次登陆时,Apifox 会默认提供一个 示例项目 进行体验,简直就像 当我看到API Hub,我就知道以后开发项目想调用第三方Api时会有多方便。 写在最后限于篇幅无法介绍更多,希望有兴趣的小伙伴可以前往 Apifox 官网 亲自体验,熟悉的 爱你的VUE 风格 一名潇洒的程序员必然要懂得提高开发效率,这样才能保证产出之余腾出时间 下班干饭 技术精进! 与诸君共勉! |
|