文档首页/代码托管 CodeArts Repo/API参考/API/V4/Repository/获取仓库最近的提交统计信息 - ShowRepoLastStatistics
更新时间：2026-01-27 GMT+08:00
查看PDF
分享

获取仓库最近的提交统计信息 - ShowRepoLastStatistics

功能介绍

获取仓库最近的提交统计信息，其中按人员统计记录最多统计按创建时间降序的前100条数据。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

codeartsrepo:repository:getRepository

Read

-

-

-

-

URI

GET /v4/repositories/{repository_id}/repository/stats/last-statistics

表1 路径参数

参数

是否必选

参数类型

描述

repository_id

是

Integer

参数解释：

仓库的ID，通过查询用户所有仓库接口查询项目列表获取。

约束限制：

不涉及。

默认取值：

不涉及。

取值范围：

1~2147483647

表2 Query参数

参数

是否必选

参数类型

描述

branch_name

是

String

参数解释：

分支名称。

约束限制：

不涉及。

取值范围：

字符串长度不少于1，不超过2000。

默认取值：

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

不涉及。

取值范围：

字符串长度不少于1，不超过10万。

默认取值：

不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

event

StatisticEventsDto object

最近的统计记录

total

Integer

参数解释：

统计信息数量

取值范围：

最小0

默认取值：

0

取值范围：

0~2147483647

statistics

Array of StatisticDto objects

统计信息

codelines

Array of CodelineDto objects

仓库近15日每日代码提交增减行数信息。

count

Integer

参数解释：

分支提交总数。

取值范围：

最小0

默认取值：

0

取值范围：

0~2147483647

all_branch_commits_count

Integer

参数解释：

仓库提交总数。

取值范围：

最小0

默认取值：

0

取值范围：

0~2147483647

表5 StatisticEventsDto

参数

参数类型

描述

id

Integer

参数解释：

统计ID。

默认取值：

不涉及。

取值范围：

1~2147483647

user_id

Integer

参数解释：

用户ID。

默认取值：

不涉及。

取值范围：

1~2147483647

project_id

Integer

参数解释：

仓库ID。

默认取值：

不涉及。

取值范围：

1~2147483647

branch

String

参数解释：

分支名。

取值范围：

最小1个字节，最大200字节

默认取值：

不涉及。

status

String

参数解释：

统计状态。

默认取值：

0

stat_date

String

参数解释：

统计时间。

created_at

String

参数解释：

统计创建时间。

updated_at

String

参数解释：

统计更新时间。

表6 StatisticDto

参数

参数类型

描述

id

Integer

参数解释：

统计ID。

取值范围：

1~2147483647

project_id

Integer

参数解释：

仓库ID。

取值范围：

1~2147483647

branch

String

参数解释：

分支名。

取值范围：

最小1个字节，最大200字节

user_name

String

用户名

add_lines

Integer

参数解释：

增加行数。

取值范围：

0~2147483647

delete_lines

Integer

参数解释：

删除行数。

取值范围：

0~2147483647

commit_count

Integer

参数解释：

总的提交数量。

取值范围：

0~2147483647

created_at

String

参数解释：

最早提交时间。

updated_at

String

参数解释：

最新更新时间。

表7 CodelineDto

参数

参数类型

描述

additions

Integer

参数解释：

增加行数。

取值范围：

最小0

默认取值：

0

取值范围：

0~2147483647

deletions

Integer

参数解释：

删除行数。

取值范围：

最小0

默认取值：

0

取值范围：

0~2147483647

date

String

参数解释：

日期，格式'yyyyMMdd',举例：20251030。

取值范围：

不涉及。

默认取值：

不涉及。

状态码：401

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

error_msg

String

参数解释：

错误信息。

状态码：403

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

error_msg

String

参数解释：

错误信息。

请求示例

GET https://{endpoint}/v4/repositories/2112029050/repository/stats/last-statistics?branch_name=main

响应示例

状态码：200

OK

{
  "event" : {
    "id" : 0,
    "user_id" : 0,
    "project_id" : 0,
    "branch" : "master",
    "status" : "finished",
    "stat_date" : "20250926",
    "created_at" : "2025-09-26T11:22:01+08:00",
    "updated_at" : "2025-09-26T11:22:01+08:00"
  },
  "total" : 2,
  "statistics" : [ {
    "id" : 1,
    "project_id" : 0,
    "branch" : "master",
    "user_name" : "xx",
    "add_lines" : 1035,
    "delete_lines" : 77,
    "commit_count" : 120,
    "created_at" : "2025-09-26T11:22:02.000+08:00",
    "updated_at" : "2025-10-22T09:58:36.000+08:00"
  }, {
    "id" : 2,
    "project_id" : 0,
    "branch" : "master",
    "user_name" : "aa",
    "add_lines" : 4,
    "delete_lines" : 23,
    "commit_count" : 8,
    "created_at" : "2025-09-26T11:22:02.000+08:00",
    "updated_at" : "2025-10-15T14:38:33.000+08:00"
  } ],
  "codelines" : [ {
    "additions" : 742,
    "deletions" : 0,
    "date" : "20251022"
  }, {
    "additions" : 4,
    "deletions" : 20,
    "date" : "20251015"
  } ],
  "count" : 139,
  "all_branch_commits_count" : 158
}

状态码：401

Unauthorized

{
  "error_code" : "DEV.00000003",
  "error_msg" : "认证信息过期"
}

状态码：403

Bad Request

{
  "error_code" : "CH.004403",
  "error_msg" : "您没有操作权限，请升级权限后重试。"
}

状态码

状态码

描述

200

OK

401

Unauthorized

403

Bad Request

错误码

请参见错误码。

父主题：Repository