当前位置: 首页 > article >正文

Apifox使用学习

Apifox是API文档、API调试、API Mock、API自动测试一体化协作平台,定位Swagger+Postman+Mock+JMeter。

只需要定义好API文档,API调试、API数据Mock、API自动化测试就可以直接使用。

API文档和API开发测试使用同一个工具,API调试完成后即可保证和API文档定义的一致性。

Apifox 是区分接口设计接口运行两个概念的。

  • 接口设计:即 新建接口 界面或接口详情里的 编辑 界面,用途是 定义接口文档规范,而不是 运行 接口,所以该界面是只能定义接口基本信息、参数名及参数说明等,而不能设置参数值参数值前置脚本/后置脚本 等信息请在接口运行界面或接口用例界面填写。
  • 接口运行:即接口详情里的 运行 界面,用途是 临时调试接口运行 完后,需要点击保存为用例,才能将填写的 参数值前置脚本/后置脚本 等信息保存下来;否则关闭 tab 后,这些信息将会丢失。

一、下载

官网:Apifox - API 文档、调试、Mock、测试一体化协作平台。拥有接口文档管理、接口调试、Mock、自动化测试等功能,接口开发、测试、联调效率,提升 10 倍。最好用的接口文档管理工具,接口自动化测试工具。Apifox = Postman + Swagger + Mock + JMeter。集接口文档工具、接口Mock工具、接口自动化测试工具、接口调试工具于一体,提升 10 倍研发效率。是最好用的API文档工具,API自动化测试工具,API Mock工具,接口文档管理工具,接口文档生成工具。icon-default.png?t=N7T8https://apifox.com/

二、接口文档设计

新建接口:

定义接口文档规范:

定义接口路径、基本信息、参数名及参数说明,不能设置参数值。

接口路径:

        不要包含http协议及域名,这部分在“环境管理”-“前置URL”中设置

        Path参数以大括号{}包裹起来;如获取用户信息/future/member/{menber_id}/info

        不可包含Query参数(即url?后的参数),在下方“请求参数”填写

请求参数:

        Params参数:包含Query参数和Path参数两部分

        Body参数:none、form-data、x-www-form-urlencoded、json、xml、binary、raw

                类型为json或xml,需设置数据结构,数据结构可以引用数据模型。

                接口发送请求时,会根据该设置自动在header加上对应Content-Type,无需手动

                设置

        Header、Cookie、Auth等

        示例值

返回响应:

        接口返回的HTTP状态码

        返回内容的数据格式:JSON、XML、HTML、Raw、Binary

        数据结构:仅JSON、XML可配置数据结构

当一个接口不同不同情况返回不同数据结构时,可设置多个返回响应

公共响应:

        主要用于实现返回响应的复用,通常不同接口在某些情况下会返回相同的数据结构,如资源不存在(404)、服务器错误(500)等,可设置公共响应,避免重复编写,方便统一管理。

响应示例:

        方便查阅接口文档的人快速了解数据结构。示例数据可设置多个:成功案例、

        失败案例。

环境管理:

        前置URL:接口运行时自动添加到接口路径前组成接口实际请求URL。

                尾部不要加上反斜杠/

        服务:当且仅当同一”环境“下,多个接口使用不同的”前置URL“时,才需要添加多个服务

        环境变量:跟随环境切换而发生改变的变量

数据结构/数据模型:

        数据结构:

        主要使用在【接口设计】的返回响应和json/xml类型的Body参数。支持增删改、拖拽。

                json/xml智能识别/快捷导入:已有JSON数据,导入后自动识别快捷生成。

                预览:根据设计的数据结构,mock出假数据,方便查看数据结构的实际效果

                生成代码:根据数据结构生成各种语言的代码

        数据模型:

                可复用的数据结构,根据项目需求,需新建,再引用。

在线分享:

        定义好的API文档,可通过在线文档分享。在线文档支持与运行调试、修改环境变量。

导入:

        支持多种数据格式的导入,方便项目迁移。导入可选的内容包括:接口

数据抓包:

在网页点击【F12】-【网络】

 


http://www.kler.cn/news/289339.html

相关文章:

  • 【华为OD】2024D卷——剩余银饰的重量
  • [CISCN2019 华东南赛区]Web111
  • Java面向对象与继承
  • 【C++】手动实现队列的封装(C++)
  • 基于纠错码的哈希函数构造方案
  • 977.有序数组的平方
  • 边缘计算工业网关可以为工业企业生产提供哪些价值应用?天拓四方
  • 如何禁用USB存储设备|禁用USB储存和连接手机的方法有哪些?深度解析,四招搞定!
  • Kafka:浅谈对Kafka的认识
  • spring之bean和配置相关注解
  • 论文解读:Prompt-aligned Gradient for Prompt Tuning
  • 论文《Improving your graph neural networks:A High-Frequency Booster》笔记
  • 构造+模拟,CF 873D - Merge Sort
  • 水平垂直居中的方式
  • Nginx - Rewirte
  • 【GPT】Coze使用开放平台接口-【5】API 调用
  • 15、Django Admin添加自定义字段功能
  • 宠物勺子秤芯片解决方案CSU8RP1186
  • 机器学习(五) -- 监督学习(8) --神经网络2
  • 苹果系统中如何安装Python和PyCharm
  • 低代码用户中心的构建与应用
  • 计算机毕业设计PySpark深度学习动漫推荐系统 动漫视频推荐系统 机器学习 协同过滤推荐算法 bilibili动漫爬虫 数据可视化 数据分析 大数据毕业设计
  • Vue3 数据通信
  • 计算机网络 第1章 概述
  • AI预测体彩排3采取888=3策略+和值012路或胆码测试9月3日升级新模型预测第71弹
  • 大数据-114 Flink DataStreamAPI 程序输入源 自定义输入源 Rich并行源 RichParallelSourceFunction
  • Meshy-4:AI驱动3D建模的革命性工具,解锁虚拟创作新高度
  • AIGC与数据分析融合,引领商业智能新变革(TOP企业实践)
  • 摄像头进行视频捕获并定时截取屏幕图像
  • 【前端面试】设计循环双端队列javascript