如何使用Bitbucket API按日期查询仓库的commit提交记录

Bitbucket 2.0版本的仓库提交查询接口原生支持通过q参数实现按提交日期过滤，具体实现方式如下：

实现规则 #

• 日期必须使用ISO 8601标准格式，支持两种常用写法：
  • 仅日期：YYYY-MM-DD（示例：2024-01-01）
  • 带时间时区：YYYY-MM-DDTHH:mm:ssZ（示例：2024-01-01T00:00:00Z，末尾Z代表UTC时区，可替换为对应时区偏移，比如+08:00代表东八区）
• q参数过滤规则：
  • 用date字段代表提交日期
  • 支持比较运算符：>（大于）、<（小于）、>=（大于等于）、<=（小于等于）
  • 多个过滤条件用AND连接，条件之间的空格需要转义为+或者%20

调用示例 #

查询2023年全年的提交记录，请求路径如下：

GET /repositories/{workspace}/{repo_slug}/commits?q=date>=2023-01-01T00:00:00Z+AND+date<=2023-12-31T23:59:59Z

注意事项 #

• 建议使用带时区的完整时间格式，避免不同时区导致的日期匹配误差
• 如果查询结果数量较多，接口会自动分页，可通过pagelen参数调整单页返回数量，最大支持100条/页，通过返回结果中的next字段获取下一页数据

内容的提问来源于stack exchange，提问作者Joey Yi Zhao