跳到主要内容

公共伙伴工作空间（Public）

Postman 社区中的任何人都可以访问公共工作空间。公共工作空间可以增强新用户使用你的 API 的入职体验，用新的用例和资源激发你的现有用户，增加你的 API 在 Postman 搜索结果中的发现率，并使你能够与合作伙伴公开合作。

公开你的团队资料​

在其他 Postman 用户可以在公共工作空间与你的团队合作之前，你的团队需要有一个公共团队资料。公共团队资料鼓励其他用户在公共工作空间与你协作，使你能够寻求贡献和收集反馈，并增加你的 API 在搜索结果中的发现率。公共团队资料也显示在 公共 API 网络 上。

要公开你的 团队资料 ，请执行以下操作：

  1. 在你头像旁边的 Postman 右上角，选择团队 > 团队设置。
  2. 选择团队配置文件。
  3. 选择公开团队资料以将资料设置为公开。

有关如何创建公开个人资料的信息，请参阅 编辑你的团队个人资料 。

创建公共工作空间​

要创建公共工作空间，请执行以下操作：

  1. 从标题中选择工作空间，然后选择**创建工作空间**。

    工作空间菜单

  2. 指定工作空间名称和摘要。

    在一个团队中，你不能有两个同名的公共工作空间。

  3. 在可见性下，选择公开。

  4. 选择创建工作空间。

    创建公共工作空间

你可以使用工作空间模板来帮助设置新的公共工作空间。有关详细信息，请参阅 使用模板创建工作空间 。

要将现有工作空间转换为公共工作空间，请执行以下操作：

  1. 打开工作空间。在概述选项卡中，选择右上角的工作空间设置。
  2. 在可见性下，选择公开。
  3. 选择更新。

你必须是工作空间 管理员 才能更改工作空间的可见性。

如果你使用的是 Postman Professional 或 Enterprise 计划，则需要获得具有 社区管理员角色的 用户的批准才能更改工作空间的可见性。在概述选项卡中，选择工作空间设置。在 Visibility下，从下拉列表中选择Public ，然后**选择 Request to Change Visibility**。

将工作空间公开后，该工作空间内的所有实体都可以通过该工作空间公开访问。

当你公开工作空间时，Postman 会向所有工作空间成员发送应用内通知和电子邮件通知。要查看你的应用内通知，请选择 变更日志图标 Postman 标题中的通知图标。

在公共工作空间邀请协作​

信息丰富且引人入胜的公共工作空间有助于提高 API 的采用率。要邀请其他用户在你的公共工作空间进行协作，你需要：

邀请协作的公共工作空间的迹象包括：

有关使用公共工作空间帮助提高 API 的采用率的更多信息，请参阅 Postman 博客上 使用公共工作空间提高 API 的采用率。

共享公共工作空间​

你可以通过直接向协作者提供其工作空间 URL来共享公共工作空间。

要访问工作空间的 URL，请执行以下操作：

  1. 转到工作空间概述页面。
  2. 将鼠标悬停在工作空间名称上以显示链接图标 链接图标 。
  3. 选择链接图标以将工作空间的 URL 复制到剪贴板。

你可以与其他用户共享此工作空间 URL。

将链接复制到工作空间

当你与非团队成员的 Postman 用户共享工作空间时，其可见性必须是公开的。如果工作空间仅限团队使用或者是私人或个人工作空间，则没有访问权限的用户将无法打开工作空间。

管理公共工作空间​

当用户打开公共工作空间时，Postman 会在概述选项卡中显示其内容、活动和成员的概述。用户与公共工作空间的内容交互，包括集合、API、环境和其他元素。 作为对工作空间具有管理员角色的 团队成员，你可以管理概览、工作空间中的元素以及工作空间的成员。

编辑公共工作空间详细信息​

具有工作空间管理员角色的 用户可以编辑工作空间详细信息，包括更新工作空间的名称、摘要、描述和可见性。有关详细信息，请参阅 编辑工作空间详细信息 。

公共 API 网络 显示你的工作空间的名称和摘要。使你的工作空间名称和摘要信息丰富，以提高其在公共 API 网络上的可见性。

将元素移动到公共工作空间​

你可以将 Postman 元素从你的个人、私人或团队工作空间移动到公共工作空间。你必须具有公共工作空间的 管理员或编辑者角色 才能将元素移动到其中。

要将现有元素移动到公共工作空间，请执行以下操作：

  1. 更多操作图标 选择集合或环境名称旁边的更多操作图标 ，然后选择移动。
  2. 选择要将集合或环境移动到的公共工作空间，然后选择“移动集合”或“移动环境”。

你移动到公共工作空间的 Postman 元素将不再存在于原始工作空间中。

如果有与移动元素关联的监视器、模拟服务器或集成，它们将保留在原始工作空间中。

API 的集合将随 API 移动到新工作空间。

从公共工作空间删除元素​

你可以从你具有 Admin 或 Editor 角色 的公共工作空间中删除 Postman 元素。

  1. 更多操作图标 选择元素名称旁边的更多操作图标 ，然后选择删除。
  2. 选择删除以确认你的选择。

你可以通过从页脚中选择删除图标 垃圾桶来检索已删除的元素 。

删除公共工作空间​

要删除公共工作空间，你必须先更改其可见性。你必须具有工作空间的 管理员角色 才能将其删除。

  1. 在工作空间概览中，选择工作空间设置。
  2. 在 Visibility下，选择Team、Private或Personal之一，然后选择Update。
  3. 更新其可见性后，选择删除工作空间。
  4. 输入工作空间名称以确认你要删除它，然后选择删除工作空间。

无法删除公共工作空间

管理公共工作空间用户和角色​

如果你是 团队管理员 ，则可以在公共工作空间中管理协作者和用户角色：

  • 邀请团队成员、群组和外部用户在公共工作空间中协作。要了解有关邀请用户在你的公共工作空间中与你一起工作的更多信息，请参阅 共享工作空间 。
  • 分配对工作空间内元素的访问权限。工作空间角色控制对元素的访问。你可以将工作空间角色分配给单个用户或用户组。要了解有关分配工作空间角色或从工作空间删除用户的更多信息，请参阅 管理工作空间角色 。

当团队成员被添加到公共工作空间时，他们将收到电子邮件和应用内通知。

在另一个用户的公共工作空间中协作​

要与其他人在他们的公共工作空间中协作，请从标题中选择工作空间，然后选择你要在其中工作的工作空间。

对于集合和环境， 创建一个分支并请求使用 拉取请求 合并更改。

对于APIs，选择 API 和版本。选择“定义”选项卡，然后选择“请求访问权限”以请求编辑者角色。

你可以使用 Postman Explore 页面的 工作空间类别 访问公共工作空间。你还可以访问你拥有的公共工作空间或在标题中使用工作空间的成员。

Postman 标题中的头像列表向你显示了你工作空间中的活动人员。此列表将包括所有具有 公开资料的 活跃用户以及选择通过不启用其公开资料而保持匿名的用户。

公共工作空间中的活跃用户

下一步​

一旦你开始在公共工作空间中协作工作，用户就可以 Forking 集合并创建拉取请求。