邮差收藏

Postman 以集合（collection）作为组织工作的基本单元：它是一个包含请求的文件夹树，每个请求都包含其方法、URL、请求头、请求体和可选脚本，以及它们之间共享的变量。导出后，它会生成一个 JSON 文件，其他人、持续集成 (CI) 作业或 Newman（Postman 的命令行运行器）都可以打开并运行该文件。

工作原理

请求会引用诸如{{baseUrl}}和{{token}}之类的变量，这些变量来自不同的环境，因此同一套集合可以同时用于本地、测试和生产环境。附加到请求的测试脚本可以断言其响应，并为下一次请求设置变量——例如，从登录中获取令牌，然后在后续的每次调用中使用它。

误解

集合本质上是文档。它记录的是用户曾经发送过的内容，而不是 API 实际接受的内容；即使集合已经过时数月，如果之前没有人添加过会导致失败的请求，它仍然会显示正常状态。从 API 的 OpenAPI 文档生成集合可以确保其准确性。

点击这里试试

每个文档页面都会导出该 API 的 Postman 集合，这些集合由与其 OpenAPI 文档相同的定义生成。此处的“工作区”工作方式相同：每个已保存的请求都包含变量、捕获和断言。

相关内容

• What OpenAPI is
• 入门指南

资料来源

• Postman collection schema

其他术语

• OpenAPI — HTTP API 的机器可读描述——包括其路径、参数、主体和响应——以 JSON 或 YAML 格式表示。
• REST API — 将系统建模为可寻址资源的 API，可通过标准 HTTP 方法进行操作。
• API 端点 — 一个 URL 加上一个 HTTP 方法——客户端可以调用的最小 API 单元。
• 查询参数 — URL 中问号后面的键值对，用于过滤、排序、分页或调整端点返回的内容。
• 路径参数 — URL 路径中的可变部分，例如/orders/42中的 42，用于标识一个特定的资源。
• HTTP 标头 — 每个请求和响应都会发送名称-值元数据，与请求体分开。

阅读英文版

所有术语 · 测试技巧 · 全部 39 个模拟 REST API

最后更新时间 2026年10月16日