分享你的工作
你可以在 Postman 元素(包括集合、API 和环境)上进行协作,方法是共享它们或将它们移动到共享的私有、团队或公共工作空间。
要使用工作空间共享你的工作,你需要登录到你的 Postman 帐户 。
此页面包含有关使用共享功能共享 Postman 集合、API 和环境的信息。其他 Postman 元素的共享方式不同:
你可以与协作者共享你的集合、API 和环境。共享元素有两种不同的方式:
要将元素的 URL 复制到剪贴板,你还可以将鼠标悬停在概览页面中的元素名称上,然后选择链接图标 。
使用姓名、电子邮件或群组共享
你可以直接与协作者(包括团队成员、群组和外部用户)共享集合、API 和环境。
- 从你要共享的元素中,选择 共享。
- 选择与人。
- 输入你要与其共享元素的人员的姓名、电子邮件地址或 群组名称。
- 如果你对要共享的元素具有编辑者角色,则可以为新协作者授予该元素的查看者或编辑者 角色 。如果你拥有该元素的查看者角色,则可以共享它,但你将无法分配角色。
- 选择共享收藏。
Postman 将告知与你共享该元素的各个团队成员和组你的协作请求。
如果你要共享的元素位于个人工作空间中,系统将提示你将工作空间可见性更改为团队或创建新的团队工作空间以放置该元素。有关详细信息,请参阅在团队工作空间中 协作 。
如果你要共享的元素位于私有工作空间中,则在与他们共享该元素时,无权访问私有工作空间的用户将被邀请为工作空间查看者。
使用 Run in Postman 按钮共享
你可以使用 Run in Postman 按钮在网站或 README 中共享集合。
- 从你要共享的元素中,选择 共享。
- 在 Postman 中选择Via Run。
有关制作和使用 Run in Postman 按钮的更多信息,请阅读 创建 Run in Postman 按钮 。
使用 Postman API 共享
要使用 Postman API 共享集合的 JSON,请执行以下操作:
- 从你要共享的元素中,选择 共享。
- 选择通过 API。
- 选择使用集合访问密钥获取集合 JSON。
- 选择生成新密钥以创建集合访问密钥。集合访问密钥使其他用户能够对集合 JSON 进行只读访问。
- (可选)选择管理密钥以在你的 API 密钥页面上查看或撤销此集合访问密钥。要了解有关集合访问密钥的更多信息,请参阅 生成集合访问密钥 。
知道此链接的任何人都可以只读访问集合的 JSON。此 Postman API 端点提供的数据反映了集合的当前状态。
集合 JSON 链接在 60 天不活动后过期。
如果要与其他用户共享链接,请选择链接到公共工作空间中的集合以提供指向集合的链接。知道此链接的任何人都可以查看和 Forking 你的收藏。
与外部用户共享元素
你的团队必须 有空位 或 启用 Auto-Flex 才能邀请更多团队成员。
当你 共享集合时,如果你是 团队管理员 或 超级管理员, 不在你的 Postman 团队中的外部用户将立即收到加入你团队的邀请。
如果你在你的团队中拥有 开发人员角色 ,并且你使用的是免费、基本或专业计划,则与你共享元素的外部用户将作为开发人员自动添加到你的团队中,无需团队管理员批准。
如果你不是免费、基本或专业计划的开发人员,也不是任何计划的团队管理员,则团队管理员必须批准你与外部用户共享元素的请求。
如果你的团队 启用了 SSO ,外部用户将需要使用你团队的 SSO 登录。
允许外部用户查看集合
你可以允许不在你的 Postman 团队中的外部用户查看特定集合并在该集合中发送请求。允许外部用户查看特定集合后,将集合 URL 发送给他们以登录 Postman 并查看集合。使用集合 URL 登录 Postman 的外部用户在团队级别被分配了 Guest 角色 ,在集合级别被分配了有限的 Viewer 角色。 为外部用户分配来宾角色不会消耗付费席位。
要允许外部用户查看集合,请执行以下操作:
从你要共享的集合中,选择 共享。
选择与人。
使用链接打开允许访客旁边的开关以加入你的团队并查看收藏。
选择复制链接以复制集合 URL。
将集合 URL 发送给你想要查看集合的外部用户。Postman 要求外部用户先登录 Postman,然后才能查看集合。
如果允许带有链接的来宾加入你的团队并查看集合旁边的切换开关已打开,则有权访问集合 URL 的任何人都可以查看集合。
该集合必须位于团队工作空间中。如果集合位于个人或私有工作空间中,则外部用户将无法查看集合。有关详细信息,请参阅 在团队工作空间中协作 。
更改外部用户对集合的访问
你可以在团队和集合级别更改外部用户的角色。你还可以撤销新的和现有的外部用户查看集合的权限。
要了解如何更改外部用户的团队角色,请参阅 管理来宾 。要了解外部用户如何请求角色更改,请参阅 以外部用户身份请求集合的编辑者角色访问权限 。
你可以使用链接关闭允许访客旁边的开关以加入你的团队并查看收藏。当你关闭此功能时,无法再为新的外部用户分配来宾角色。已分配来宾角色的外部用户将继续有权访问该集合。如果为外部用户可以访问的所有集合关闭此功能,他们将从团队中删除并且无法访问团队中的集合。
要在团队级别删除外部用户,请参阅 删除团队成员 。在某些情况下,只能访问一个集合的访客会自动从团队中删除:
- 如果工作空间管理员将它们从集合中删除
- 如果工作空间管理员从集合所在的工作空间中删除来宾
- 如果工作空间管理员将集合所在工作空间的可见性更改为私有
- 如果工作空间管理员删除集合所在的工作空间
要在集合级别删除外部用户,请执行以下操作:
选择集合名称旁边的更多操作图标 ,然后选择管理角色。
为要撤销对集合的访问权限的用户选择删除。
选择更新角色。
从集合中删除外部用户不会撤销他们对集合所在工作空间的访问权限。要撤销他们对团队的全部访问权限,请参阅 删除团队成员 。