如何通过Azure DevOps REST API查询特定分支的贡献权限？

一、修复分支权限查询的Token格式问题 #

你当前的请求忽略分支部分，核心原因是分支名称未做URL编码，导致API无法正确识别分支路径。正确的Token格式需要对分支名称中的特殊字符（如斜杠、空格）进行URL编码，完整Token结构如下：
repoV2/{projectId}/{repoId}/refs/heads/{encodedBranchName}

正确请求示例 #

GET https://dev.azure.com/{organization}/_apis/permissions/2e9eb7ed-3c0a-47d4-87c1-0ffdd275fd87/4?tokens=repoV2/{projectId}/{repoId}/refs/heads/{encodedBranchName}&api-version=7.0

比如分支名为release/v1.0，编码后为release%2Fv1.0，对应的Token就是repoV2/{projectId}/{repoId}/refs/heads/release%2Fv1.0。

结果验证 #

响应中token字段会明确指向分支路径，effectivePermission值为1表示拥有贡献权限，0表示无权限。

二、通过角色验证权限的备选方案 #

若分支权限通过自定义角色分配，可通过以下步骤验证用户角色：

1. 获取目标角色ID
   请求项目角色列表，找到包含分支贡献权限的自定义角色：

GET https://dev.azure.com/{organization}/{project}/_apis/securityroles/scopes/projectrole/roles?api-version=7.0

记录该角色的id字段值。

2. 查询用户角色成员身份
   通过角色ID查询成员，若结果包含当前用户，则说明拥有对应权限：

GET https://dev.azure.com/{organization}/{project}/_apis/securityroles/scopes/projectrole/roles/{roleId}/members?api-version=7.0

三、直接查询分支权限设置 #

也可直接请求分支的权限条目，匹配当前用户的权限：

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repoId}/permissions?scope=refs/heads/{encodedBranchName}&api-version=7.0

遍历响应的value数组，找到对应当前用户的条目，查看allow字段是否包含位掩码4（贡献权限的标识位），包含则表示有权限。

内容的提问来源于stack exchange，提问作者Titouan Ferdoel