TRAE CN
TRAE CN
API 参考
请输入
数据分析
- 文档首页
TRAE CN数据分析按 Commit 获取 AI 贡献率
复制全文
下载 pdf按 Commit 获取 AI 贡献率
文档反馈
问问助手按提交记录维度获取指定时间范围内的 AI 代码贡献数据。
所需权限
statistics
请求说明
- 请求方式：POST
- 请求地址：{域名}/openapi/v1/statistics/commit-metrics
请求参数
请求头参数
Header 参数 | 是否必填 | 描述 |
Header 参数 | 是否必填 | 描述 |
Authorization | 是 | |
Content-Type | 是 | 固定取值为 application/json。 |
请求体参数
参数 | 类型 | 是否必填 | 默认值 | 描述 |
参数 | 类型 | 是否必填 | 默认值 | 描述 |
start_date | string | 是 | - | 开始日期。格式：YYYY-MM-DD。 |
end_date | string | 是 | - | 结束日期。格式：YYYY-MM-DD。 |
timezone | string | 否 | "Asia/Shanghai" | 时区。需使用 IANA 时区名称。 |
repo_urls | string[] | 否 | - | 仓库 URL 列表，用于筛选指定仓库。最多传入 100 个。未传入时，查询范围包括企业下的所有仓库。 |
commit_ids | string[] | 否 | - | 提交 ID 列表，用于筛选指定提交记录。 |
emails | string[] | 否 | - | 提交者邮箱列表，用于筛选指定提交者。最多传入 100 个。 |
page | int | 否 | 1 | 页码。 |
page_size | int | 否 | 100 | 每页数量，最大为 500。 |
响应参数
参数 | 类型 | 描述 |
参数 | 类型 | 描述 |
data.items | array | 按提交记录维度返回的查询结果。 |
data.items[].commit_id | string | 提交哈希。 |
data.items[].repo_url | string | 仓库 URL。 |
data.items[].email | string | 提交者邮箱。 |
data.items[].user_id | int64 | 成员的 ID。 |
data.items[].commit_time | int64 | 提交时间，以 Unix 毫秒时间戳表示。 |
data.items[].ai_commit_lines | int64 | 该提交中由 AI 生成的代码行数。 |
data.items[].non_ai_commit_lines | int64 | 该提交中非 AI 生成的代码行数。 |
data.items[].total_commit_lines | int64 | 该提交包含的代码总行数，即 ai_commit_lines 与 non_ai_commit_lines 之和。 |
data.items[].ai_contribution_rate | float64 | 该提交的 AI 代码贡献率（%）。计算公式：ai_commit_lines ÷ total_commit_lines × 100%。 |
示例
请求示例
curl -X POST "${HOST}/openapi/v1/statistics/commit-metrics" \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"start_date": "2026-08-01",
"end_date": "2026-08-07",
"repo_urls": ["https://git.example.com/org/trae-server"],
"commit_ids": ["a1b2c3d4e5f60789xxxxxx1234567890abcdef12"],
"emails": ["name@example.com"],
"page": 1,
"page_size": 100
}'
响应示例
{
"code": 0,
"message": "success",
"request_id": "req_abc123xyz",
"data": {
"items": [
{
"commit_id": "a1b2c3d4e5f60789xxxxxx1234567890abcdef12",
"repo_url": "https://git.example.com/org/trae-server",
"user_id": 12314124,
"email": "name@example.com",
"commit_time": 1737000000000,
"ai_commit_lines": 128,
"non_ai_commit_lines": 32,
"total_commit_lines": 160,
"ai_contribution_rate": 80.0
}
],
"pagination": {
"page": 1,
"page_size": 100,
"total": 356,
"total_pages": 4
}
}
}
错误码
最近更新时间：2026.10.22 11:03:20
这个页面对您有帮助吗？
有用
有用
无用
无用