跳到主要内容

使用集合（Collections）

你可以将你的 Postman 请求和示例分组到集合中，以保持你的工作空间井井有条、与团队成员协作、生成 API 文档和 API 测试以及自动执行请求运行。

在侧边栏中选择集合以获取工作空间中的集合列表。

创建集合​

有几种创建新集合的方法：

  • 在边栏中选择收藏，然后选择**+**。

    创建新集合

  • 选择新建，然后选择收藏。

  • 在左侧边栏中打开收藏后，选择+。

  • 在空工作空间中，选择Create Collection。

  • 你还可以 从模板创建集合 。

要自定义和配置新集合，请执行以下操作：

  1. 选择编辑图标 编辑图标 为你的新收藏命名。

  2. 你可以选择为你的收藏指定 描述 。选择文档图标 文档图标 ，然后选择编辑图标 编辑图标 来编写你的描述。当任何人打开它时，此描述将出现在其文档和工作空间中。

    你还可以选择概述来指定和查看你的收藏的描述。

  3. 选择授权以配置集合的授权详细信息。

  4. 选择预请求脚本为你的集合定义一个 预请求脚本 ，该脚本将在请求发送到服务器之前运行。

  5. 选择测试为你的集合定义 测试脚本 ，该脚本将在收到响应后运行。

  6. 选择变量以定义 集合变量 的值以在集合中的所有请求之间共享。

编辑集合详细信息

将请求添加到集合​

有几种方法可以将现有的和新的请求添加到集合中。

将现有请求移动到不同的集合​

要将现有请求移动到不同的集合，请执行以下操作：

  1. 选择你要移动的请求。
  2. 将请求拖到所需的集合中。

或者，打开请求并选择另存为，然后选择要将其复制到的集合。

要将多个请求移动到不同的集合，请执行以下操作：

  1. 按住⌘或Ctrl，然后选择要移动的请求。
  2. 将请求拖到所需的集合中。

向集合添加新请求​

  1. 从新请求中，选择保存。
  2. 选择要将其移动到的集合，然后选择“保存”。
  3. 要创建一个新的集合来保存请求，请选择New Collection。

在集合中创建新请求​

  1. 更多操作图标 选择集合名称旁边的更多操作图标 。

  2. 从操作菜单中选择添加请求。

    将请求添加到文件夹

向空集合添加请求​

选择集合，然后选择添加请求。

向空集合添加请求

将历史记录中的请求添加到集合中​

  1. 在边栏中选择历史记录。

  2. 更多操作图标 选择要保存的请求旁边的更多操作图标 。

  3. 选择保存请求。

    从历史记录中保存请求

  4. 选择要将请求添加到的集合，然后选择保存。

或者，选择请求旁边的+ 。

管理集合​

基本动作​

从工作空间的集合列表中，你可以：

  • 选择一个集合以在选项卡中打开其概览。
  • 通过选择集合名称旁边的箭头打开和关闭集合内容。
  • 将鼠标悬停在集合名称上并选择星形图标 ★ 将该集合移至列表顶部。
  • 使用集合搜索栏筛选你的集合。
  • 通过拖放对集合中的请求、文件夹和示例进行重新排序。

将文件夹添加到集合​

  1. 更多操作图标 选择集合名称旁边的更多操作图标 。
  2. 选择添加文件夹。

你还可以添加子文件夹来为集合的请求和示例创建额外的嵌套级别。

删除集合​

  1. 更多操作图标 选择集合名称旁边的更多操作图标 。
  2. 选择删除。

你还可以选择收藏集，然后按键盘上的Delete 键。

如果删除的收藏集大于 30 MB，你将无法 恢复它 。为避免这种情况，你可以在删除集合之前将其拆分为更小的部分，或者先备份集合。

恢复已删除的集合​

  1. 更多操作图标 选择集合搜索栏旁边的更多操作图标 。

  2. 选择打开垃圾箱。

    或者， 从 Postman 页脚中选择删除图标 垃圾桶。

  3. 恢复图标 在“垃圾箱”页面中，选择要恢复的集合旁边的恢复图标 。

无法恢复大于 30 MB 的已删除集合。

恢复选项取决于你的 Postman plan：

  • 免费帐户：恢复收藏最多一天。
  • Postman Basic：恢复收藏长达 30 天。
  • Postman Professional 和 Enterprise：恢复收藏长达 90 天。

如果你希望位于废纸篓中的集合不存在，则它可能已从工作空间中移除，而不是被删除。如果集合出现在另一个工作空间中，你可以通过选择共享来移动它。

分享收藏​

要与其他用户共享集合，你可以：

看一个集合​

当你查看集合时，Postman 会在工作空间团队成员对集合进行更改时通知你，包括添加新请求、修改现有请求、添加或更新变量、编辑请求前脚本或测试以及添加或删除文件夹. 你可以观看你拥有的收藏集，也可以观看任何公共工作空间中的收藏集。

要观看集合，请执行以下操作：

  1. 选择观看图标 观看图标 开始观看收藏。

收藏看

要查看有关你观看的集合中发生的更改的通知，请执行以下操作：

  1. 选择 Postman 标题中的通知图标 通知图标 以查看通知。选择查看更改日志以查看集合的更改日志。

    通知收看

  2. 你还将收到一封电子邮件，其中包含有关更改人、更改内容以及更改时间的信息。在电子邮件中选择查看更改日志以访问 Postman 中的完整更改日志。

如果你创建一个集合并从同一个 Postman 帐户更改它，你将不会收到你对该集合所做的任何更改的通知。

Forking 一个集合​

你可以在自己的工作空间中派生集合来 开发集合版本 。

  1. 更多操作图标 选择集合名称旁边的更多操作图标 。
  2. 选择Forking。

Forking图标 或者，从集合概览中选择 Forking 图标 。

  1. 评论图标 从右侧边栏中选择评论图标 。
  2. 写下你的评论，然后选择添加评论。

还原集合更改​

要将你的收藏恢复到较早的状态，请执行以下操作：

  1. 变更日志图标 选择右侧的更改日志图标 。

  2. 选择一个会话以展开它。

  3. 更多操作图标 选择要将收藏集恢复到的更改旁边的更多操作图标 ，然后选择恢复到此更改。

    从变更日志中恢复

从更改日志中恢复集合会将其恢复到你选择的更改发生后的状态。

查看拉取请求、Forking 和集合详细信息​

从右侧边栏：

在开发工作流程中使用集合​

集合可以为 API 开发、测试和发布工作流的各个部分提供支持。

使用集合模板​

创建收藏集时不确定从哪里开始？你可以从模板创建集合，而不是从头开始。有几个集合模板可用于开始集成、API 文档、条件工作流或数据可视化。

有几种方法可以从模板创建集合：

  • 首次创建帐户时，系统会询问你是否要从模板创建集合。
  • 在空白工作空间的左侧边栏中，选择“使用模板”。
  • 选择新建，然后选择使用模板。
  • 在空集合中，在概览选项卡上，选择一个模板。

关于多协议请求集合​

你还可以将多协议请求（例如 WebSocket 和 gRPC 请求）保存到集合中。

由于多协议请求与 HTTP 请求具有不同的特性，因此当它们被保存到一个集合中时，它会导致该集合处于具有某些限制的“测试版”状态。

处于此状态时，集合只能包含 WebSocket 或 gRPC 请求，而不能包含 HTTP 请求。也不支持与集合相关的一些功能。