Bitbucket Server v5.2.0：如何获取指定时间段仓库活动列表

我来帮你搞定Bitbucket Server v5.2.0的仓库活动查询问题！针对你遇到的REST API无效的情况，我给你整理了适配这个旧版本的具体操作步骤：

第一步：确认关键参数 #

首先你得拿到两个核心参数：

• 项目Key：从仓库URL里提取，比如你的仓库地址是https://your-bitbucket/projects/PROJ/repos/my-repo/browse，这里的PROJ就是项目Key
• 仓库Slug：上面例子里的my-repo就是仓库slug（通常是仓库名的小写连字符格式）

方案一：仅获取指定时间段的提交记录 #

如果你的目标是获取提交历史，用这个API端点：

GET /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/commits

关键参数说明： #

• since：起始时间，必须是ISO 8601格式（比如2024-01-01T00:00:00.000Z，Z代表UTC时区，也可以用+08:00这样的偏移）
• until：结束时间，格式同上
• limit：单次请求返回的最大记录数，默认是25，建议设为1000减少分页次数
• start：分页起始位置，当返回结果里有nextPageStart时，用这个参数获取下一页数据

示例CURL命令： #

curl -u 你的用户名:你的密码 "https://你的BitBucket地址/rest/api/1.0/projects/PROJ/repos/my-repo/commits?since=2024-01-01T00:00:00.000Z&until=2024-06-01T23:59:59.999Z&limit=1000"

方案二：获取仓库全部活动（提交、PR、评论、分支操作等） #

如果需要涵盖所有类型的仓库活动，用这个端点：

GET /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/activities

这个端点返回的每个活动对象都有type字段，比如COMMIT（提交）、PULL_REQUEST_OPENED（PR创建）、COMMENT_ADDED（评论添加）等，你可以根据这个字段过滤需要的活动类型。

示例CURL命令： #

curl -u 你的用户名:你的密码 "https://你的BitBucket地址/rest/api/1.0/projects/PROJ/repos/my-repo/activities?since=2024-01-01T00:00:00.000Z&until=2024-06-01T23:59:59.999Z&limit=1000"

常见问题排查 #

如果之前的方案无效，大概率是这几个原因：

1. 版本不兼容：你参考的方案可能是针对Bitbucket Cloud或更高版本的Server，v5.2.0的API端点和参数有差异，上面的方案是完全适配v5.2.0的
2. 时间格式错误：必须严格使用ISO 8601格式，不能用普通的YYYY-MM-DD格式
3. 权限不足：确保调用API的用户拥有仓库的REPO_READ权限，否则会返回403错误
4. 分页遗漏：如果活动数量超过limit设置的值，需要用start参数分页获取所有数据

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