Postman 怎样用示例响应固定接口联调数据

后端接口还没有稳定时，前端不必一直等真实服务。Postman 可以把集合中的一次请求和返回结果保存成 Example，再用这些示例创建 Mock Server，让调用方先按固定的路径、状态码和 JSON 结构联调。关键不是随便保存一段 JSON，而是把请求与对应响应绑定起来，后续 Mock 才知道该返回哪个场景。

官方地址：https://learning.postman.com/docs/design-apis/mock-apis/tutorials/mock-with-examples

最短操作路径是：准备集合请求，发送一次代表性请求，保存为 Example，补齐成功或异常响应，再从集合创建 Mock Server。前端改用生成的 Mock 地址调用，看到预期状态码和响应体后，就可以继续开发。

先准备一个能代表联调场景的请求

打开 Postman 后，先在一个 Collection 中准备请求。以订单摘要为例，请求可以是 GET /orders/summary，响应包含订单数量、金额和更新时间。这里的重点是让请求方法、路径、查询参数和响应结构接近前端真正会使用的接口。

如果集合里还没有请求，可以先建立一个最小请求；如果已经有请求，直接复用它，不要为了做 Mock 再复制一份同名请求。示例绑定在集合请求上，重复复制会让后续维护变得混乱。

{
  "code": 0,
  "data": {
    "orderCount": 12,
    "totalAmount": "486.00",
    "updatedAt": "2026-10-19T09:00:00Z"
  }
}

上面只是一个严格合法的响应示例，字段含义在正文中解释，不代表 Postman 会自动生成这段业务数据。真实操作时，应根据团队已经约定的字段名和状态码保存示例。

发送请求并保存为 Example

在请求编辑页点击 Send，确认响应面板里已经出现有代表性的状态码、响应头和响应体。随后在响应区域找到保存响应或创建示例的入口，选择 Save as example（不同版本的界面文案可能略有差异）。

1. 确认当前打开的是目标 Collection 下的请求。
2. 点击 Send，让响应面板出现要保留的返回结果。
3. 从响应区域打开保存示例的操作，选择 Save as example。
4. 为示例填写能表达场景的名称，例如“订单汇总成功”。
5. 保存后回到集合树，展开请求查看 Example 是否挂在该请求下面。

保存完成后，Example 同时记录请求和响应。也就是说，之后 Mock Server 匹配的不只是一个返回 JSON，还会参考请求的路径、方法以及示例所属集合。

把成功、空数据和错误场景分开保存

一个示例只能表达一个清晰的返回场景。为了让前端联调更有用，可以围绕同一个请求保存多个 Example：

• 订单汇总成功：状态码为 200，返回正常数据。
• 订单列表为空：状态码仍可为 200，但 data 中的列表为空。
• 参数缺失：使用 400，并在响应体中给出可识别的错误码。

编辑示例时，要同时核对状态码、响应体和必要响应头。不要只改 JSON 却保留与场景不匹配的状态码，否则前端可能无法覆盖错误分支。

// 中文注释：在 Postman 的 Post-response 脚本里检查示例约定的业务字段。
const body = pm.response.json();

// 中文注释：只在响应确实成功时保存一个可供后续请求使用的标记。
if (pm.response.code === 200 && body.code === 0) {
  pm.collectionVariables.set("order_summary_ready", "true");
}

// 中文注释：失败场景不写成功标记，避免后续请求误判联调状态。
if (pm.response.code !== 200 || body.code !== 0) {
  pm.collectionVariables.unset("order_summary_ready");
}

这段脚本用于说明场景判断和变量范围，不会替代 Example 的保存动作。若只是固定 Mock 返回，可以不写脚本；只有在集合运行时还需要传递状态时，才把脚本作为额外的联调辅助。

从集合示例创建 Mock Server

完成至少一个 Example 后，回到集合的操作菜单，选择创建 Mock Server 的入口。向导中通常需要确认使用哪个 Collection，以及是否使用集合里保存的示例作为返回来源。这里选择 Use examples，让 Mock Server 以已有 Example 为响应依据。

1. 在侧边栏找到包含 Example 的 Collection。
2. 打开集合操作菜单，选择创建或部署 Mock Server。
3. 在向导里选择当前 Collection，并启用使用示例的选项。
4. 填写 Mock Server 名称，确认可见范围和访问权限符合团队联调需要。
5. 点击 Create，保存生成的 Mock URL。

公共 Mock 和私有 Mock 的访问条件不同。私有服务通常需要工作区权限或有效的 Postman API Key；不要把密钥写进文章、集合示例或前端仓库。本文只讨论示例驱动的联调链路，不展开真实鉴权配置。

用 Mock URL 调用并核对匹配结果

创建完成后，复制生成的 Mock URL，把它替换到前端或另一个 Postman 请求的基础地址中。请求方法和路径要与保存 Example 时一致，查询参数也要尽量保持在示例覆盖范围内。

# 中文注释：把 MOCK_BASE_URL 换成向导生成的 Mock Server 地址。
curl --request GET \
  --url "${MOCK_BASE_URL}/orders/summary" \
  --header 'Accept: application/json'

调用后重点核对三项：

1. HTTP 状态码是否与选中的 Example 一致，例如成功场景返回 200。
2. 响应体字段是否保留了前端需要的结构，例如 data.orderCount。
3. 切换到另一个 Example 后，是否能覆盖空数据或错误分支。

如果返回结果不是预期示例，先检查请求的 HTTP 方法、路径、查询参数和 Example 是否仍属于当前 Collection。Mock Server 是按请求匹配示例的，保存的示例越多，匹配条件越要保持清晰。

常见问题

为什么保存了响应，却没有看到 Mock 返回这段数据？

检查创建 Mock Server 时是否选择了包含该 Example 的 Collection，并确认向导使用的是示例响应。另一个常见原因是调用路径或方法与保存 Example 时不同，导致没有匹配到目标示例。

一个请求能不能准备多个返回状态？

可以。为同一个请求保存多个 Example，分别命名成功、空数据和错误场景，并为每个场景维护对应的状态码、响应体和响应头。调用时再根据 Mock 的匹配规则选择合适示例。

Mock Server 能不能代替真实接口验收？

不能。Mock 适合在真实服务未就绪时固定契约、联调页面和覆盖分支；它不会验证数据库、权限、业务计算或真实网络链路。真实接口上线前仍需单独进行接口测试和集成验收。

最后确认这条联调链路

回到 Collection 侧边栏，确认请求下面至少有一个命名清楚的 Example；再用生成的 Mock URL 调用同一路径，确认状态码和响应字段与示例一致。只要“请求—示例—Mock URL—固定响应”四个环节能够对应起来，前端就可以在真实后端完成前继续推进页面和错误分支。