如何通过GitLab API查询指定项目下多个用户ID/用户名对应的合并请求

接口限制说明 #

GitLab v4 「列出项目合并请求」接口暂不原生支持多用户检索，author_id、author_username 两个作者筛选参数仅支持传入单个字符串值，无法直接传入用户ID/用户名列表批量查询。

单用户查询的官方请求格式如下：
https://<gitlab域名>/api/v4/projects/<项目ID>/merge_requests?author_username=<指定用户名>

可选实现方案 #

方案1：批量单用户请求合并结果 #

适合查询的用户数量较少的场景，遍历待查询的用户列表，逐个发起查询请求后合并返回结果即可。
示例逻辑（Python伪代码）：

import requests

GITLAB_DOMAIN = "你的GitLab域名"
PROJECT_ID = "目标项目ID"
TARGET_USERNAMES = ["user1", "user2", "user3"] # 待查询用户名列表
PRIVATE_TOKEN = "你的访问令牌"
headers = {"PRIVATE-TOKEN": PRIVATE_TOKEN}

all_mrs = []
for username in TARGET_USERNAMES:
    url = f"https://{GITLAB_DOMAIN}/api/v4/projects/{PROJECT_ID}/merge_requests?author_username={username}&state=all&per_page=100"
    resp = requests.get(url, headers=headers)
    all_mrs.extend(resp.json())
# all_mrs即为所有目标用户的合并请求列表

方案2：全量拉取本地过滤 #

适合查询的用户数量较多、或者项目合并请求总量不大的场景，仅需发起少量分页请求拉取项目下所有符合状态的合并请求，再本地按作者字段过滤即可，可减少请求次数避免触发接口限流。
过滤逻辑示例：

# 先拉取项目所有合并请求到all_project_mrs变量
target_user_ids = [123, 456, 789] # 待查询用户ID列表
target_mrs = [mr for mr in all_project_mrs if mr["author"]["id"] in target_user_ids]

注意事项 #

• 接口单页默认返回20条数据，可通过per_page参数调整最大为100条，查询结果超过单页上限时需要自行处理分页逻辑，拉取所有页数据
• 调用接口需使用有目标项目读取权限的个人访问令牌，令牌需要开通read_api权限

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