API 调试工具校验 JSON Mock 接口(二):有参验证

发布于:2025-06-25 ⋅ 阅读:(15) ⋅ 点赞:(0)

API 调试工具校验 JSON Mock 接口(一):无参请求与基础响应验证


在前一章中,JSON Mock 工具为前端开发者提供了独立构建和测试接口的能力。API 调试工具 发送请求并验证 Mock 接口的响应是否符合预期。本文将扩展实现有参验证,清晰呈现从静态到动态验证的完整过程。

一、本质:什么是 “有参接口”?

“有参接口” = 接口根据请求中携带的参数,动态返回不同数据
比如:

  • 传 {"brand": "索尼"} → 返回索尼的商品信息;
  • 传 {"brand": "苹果"} → 返回索尼的商品信息(需 Mock 工具配置对应逻辑 )。

二、前提:让 Mock 接口 “理解参数”

要实现 “有参”,需让工具:

  1. 接收参数:能读取 API 开发调试工具 发送的 brand
  2. 动态响应:根据 brand 的值,返回不同数据。

Step 1:确定参数传递方式

接口的请求方法决定了参数放哪里:

请求方法 参数位置 示例
GET URL 的查询参数(Query) https://xxx?brand=索尼
POST 请求体(Body) {"brand": "索尼"}(JSON 格式)

一、核心目标(POST 场景)

让JSON Mock 接口:

  1. 接收 Postman 发送的 请求体参数(如 {"brand": "索尼"} );
  2. 根据参数动态返回数据(如 brand=索尼 时 foundedYear=1946 )。

二、Step 1:修改 Mock 接口为 POST 方法

  1. JSON Mock 工具中,找到接口的 “请求方法” 设置(截图顶部是 GET goods );
  2. 将方法从 GET 切换为 POST(一般是下拉框选择 );
  3. 保存配置(点击 Save )。

三、Step 2:API调试工具发送 POST 有参请求

目标:工具能解析 API开发调试工具 (Postman)发送的 JSON 参数(如 {"brand": "索尼"} ),并动态返回数据。

(一)新建 / 编辑 Postman 请求

  1. 方法:选 POST
  2. URL:填写 Mock 接口地址(如 https://xxx/mock/xxx )。

(二)配置请求体(Body)

  1. 切换到 Body → 选 Content-Type 类型 → application/json
  2. 填入参数(示例):
    {
      "brand": "索尼"
    }

(三)发送请求

点击 SendAPI开发调试工具 会发送一个 POST 请求,请求体包含 {"brand": "索尼"}

四、Step 3:验证响应(3 个核心点)

1. 参数是否被工具 “接住”

响应体的 brand 字段,是否等于你传的 索尼

2. 动态逻辑是否生效

若传 {"brand": "苹果"}brand是否发生变化:

3. 原有动态数据是否正常

productTypes1.price 仍需在 60-100 随机生成,description 仍为随机句子。

三、总结:当前结论的价值

已验证静态参数映射逻辑(传 brand=索尼 精准返回索尼数据 ),可作为 “基础有参验证” 的结论,证明接口能识别参数并返回预设内容。