如何通过Bitbucket API获取所有授权用户列表？

首先明确说：目前Bitbucket的官方API确实没有提供一个直接获取仓库所有授权用户列表的端点——不管是云版本还是服务器/数据中心版本，这不是你漏看了文档，而是当前API的设计限制。

先理清两个概念的区别 #

你提到的那篇《BitBucket get list of all contributors》的文章，聚焦的是仓库的所属用户/创建者这类角色，而你需要的是所有被授予仓库访问权限的用户（包括团队成员、外部协作者、通过权限组间接获得权限的用户等），这两者的范围完全不同，所以那篇文章的方案对你不适用。

为什么没有直接的API端点？ #

Bitbucket的权限体系是分层的（仓库级、工作区/项目级、全局级），权限可以通过直接赋予单个用户、加入权限组、继承上级权限等多种方式获得。官方API目前只提供了针对「单个用户权限查询」「单个权限组查询」「直接授权用户列表」这类细分场景的端点，没有一个能一次性遍历所有层级、所有渠道获得授权的用户的接口。

可行的替代方案 #

如果一定要通过API实现，只能通过组合多个端点来拼凑数据，步骤大概是这样：

• 第一步：获取仓库直接授权的单个用户列表
  使用端点：GET /2.0/repositories/{workspace}/{repo}/permissions/users
• 第二步：获取仓库关联的所有权限组
  使用端点：GET /2.0/repositories/{workspace}/{repo}/permissions/groups
• 第三步：遍历每个权限组，获取组内成员列表
  使用端点：GET /2.0/workspaces/{workspace}/groups/{group_slug}/members
• 第四步：如果你的仓库权限继承自工作区/项目，还需要额外查询工作区的权限组和成员，再合并去重

另外，如果你不需要自动化操作，作为仓库管理员可以直接在Bitbucket UI里导出权限列表：

• 云版本：进入仓库→「设置」→「权限」，页面底部有导出选项
• 服务器/数据中心版本：进入仓库→「权限」→「管理权限」，找到导出功能

补充说明 #

对于Bitbucket Server/Data Center版本，API端点的路径会有所不同（比如前缀是/rest/api/1.0），但核心逻辑依然是需要组合多个接口来汇总所有授权用户，没有更简便的直接查询方式。

内容的提问来源于stack exchange，提问作者Chris F