对集合中的请求进行分组

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

选择Postman 左侧边栏中的Collections以查看工作区中的集合列表。

内容

创建集合

有几种方法可以创建新集合:

  • 选择左侧边栏中的集合,然后选择+

    创建新集合
  • 选择New按钮,然后选择Collection

  • 在 Postman 标题中选择Home 。选择新建,然后选择收藏

创建新集合后,您可以对其进行自定义和配置:

  1. 选择铅笔图标编辑图标为您的新集合命名。
  2. 您可以选择为您的集合指定描述。选择文档图标文档图标,然后选择铅笔图标编辑图标来编写您的描述。当任何人打开它时,此描述将出现在其文档和工作区中。
  3. 选择授权以配置集合的授权详细信息。
  4. 选择请求脚本为您的集合定义一个预请求脚本,该脚本将在请求发送到服务器之前运行。
  5. 选择测试为您的集合定义一个测试脚本,该脚本将在收到响应后运行。
  6. 选择变量以定义集合变量的值,以便在集合中的所有请求之间共享。

编辑收藏详情

向集合添加请求

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

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

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

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

或者,打开请求并选择Save As,然后选择要将其移动到的集合。

向集合添加新请求

向集合添加新请求:

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

在集合中创建新请求

在集合中创建新请求:

  1. 三个点图标选择集合名称旁边的三个点。

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

    将请求添加到文件夹

或者,选择新建,然后选择请求

向空集合添加请求

向空集合添加请求:

  1. 选择集合,然后选择添加请求

    向空集合添加请求

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

要从您的历史记录中保存请求:

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

  2. 三个点图标选择要保存的请求旁边的三个点。

  3. 选择保存请求

    保存历史请求
  4. 选择要将请求添加到的集合,然后选择Save

或者,选择请求旁边的+按钮。

管理收藏

基本动作

从工作区中的集合列表中,您可以:

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

将文件夹添加到集合

要将文件夹添加到您的收藏:

  1. 三个点图标选择集合名称右侧的三个点。
  2. 选择添加文件夹

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

删除集合

要删除集合:

  1. 三个点图标选择集合名称右侧的三个点。
  2. 选择删除

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

恢复已删除的集合

要恢复已删除的集合:

  1. 三个点图标选择集合搜索栏旁边的三个点。

  2. 选择打开垃圾箱

    外部链接图标或者,从 Postman 右下角的状态栏中选择垃圾桶图标。

  3. 在“废纸篓”页面中,选择要恢复外部链接图标的集合旁边的恢复图标。

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

恢复选项取决于您的 Postman 计划:

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

如果您没有看到您希望在“废纸篓”页面中看到的集合,则它可能已从工作区中删除而不是删除。如果集合出现在另一个工作区中,您可以通过选择共享来移动它。

共享收藏

要与其他用户共享您的收藏,您可以:

看合集

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

观看收藏:

  1. 选择手表图标外部链接图标开始观看收藏。

收藏观看

要查看有关您观看的收藏中发生更改的通知:

  1. 更改日志图标选择Postman 右上角的铃铛图标以查看通知。选择查看更改日志以查看集合的更改日志。

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

如果您从同一个 Postman 帐户创建并修改集合,您将不会收到有关您对该集合所做的任何更改的通知。

分叉集合

您可以在自己的工作区中创建集合以开发集合版本。分叉一个集合:

  1. 三个点图标选择集合名称右侧的三个点
  2. 选择分叉

叉子图标或者,从集合概览中选择叉形图标。

向集合添加评论

要在集合级别添加评论:

  1. 选择集合概览右侧的评论图标更改日志图标
  2. 写下您的评论,然后选择添加评论

还原集合更改

要将您的收藏恢复到以前的状态:

  1. 从集合概览右侧选择更改日志图标更改日志图标

  2. 为要将集合还原到的状态选择“还原”。

    使用更改日志将集合恢复到以前的状态

查看拉取请求、分叉和集合详细信息

从集合概览右侧的上下文栏中:

  • 要查看集合的拉取请求,请选择拉取请求图标拉取请求图标
  • 要查看从集合创建的分叉,请选择分叉图标叉子图标
  • 要查看有关集合的其他信息,包括模拟服务器、监视器和集成,请选择信息图标信息图标

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

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

  • 选择Run以访问Collection Runner,它允许您运行集合中的所有请求并将测试工作流构建到您的运行中。
  • 选择文档图标以从集合文档图标中生成API 文档。
  • 将监视器附加到集合可让您安排集合运行。选择集合名称旁边的三个点三个点图标,然后选择Monitor collection
  • 您可以在测试和开发期间使用模拟服务器返回示例数据。选择集合名称旁边的三个点三个点图标,然后选择Mock collection
  • 使用Postman API Builder从 API 规范生成集合。