Header 参数	是否必填	描述
`Authorization`	是	固定取值为 `Bearer {access_token}`。关于如何获取访问令牌，参考鉴权。
`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 个，不能与 `repo_names` 同时传入。若两个参数均未传入，则返回企业下所有仓库的数据。
`repo_names`	string[]	否	-	仓库名称列表，用于筛选指定仓库。最多传入 100 个，不能与 `repo_urls` 同时传入。
`sort_by`	string	否	`"ai_contribution_rate"`	排序字段。可选值：`ai_contribution_rate`、`ai_commit_lines`、`total_commit_lines`。
`order`	string	否	`"desc"`	排序方向。可选值：`asc`、`desc`。
`page`	int	否	`1`	页码。
`page_size`	int	否	`100`	每页数量，最大为 500。

响应参数

以下为该接口特有的响应参数。通用响应参数参考通用响应格式。

参数	类型	描述
`data.items`	array	按仓库维度返回的查询结果。
`data.items[].repo_url`	string	仓库 URL。
`data.items[].metrics`	object	该仓库的 AI 代码贡献数据。
`data.items[].metrics.ai_contribution_rate`	float64	AI 代码贡献率（%）。
`data.items[].metrics.ai_commit_lines`	int64	AI 生成的代码被提交到仓库的总行数。
`data.items[].metrics.non_ai_commit_lines`	int64	非 AI 生成的代码被提交到仓库的总行数。
`data.items[].metrics.total_commit_lines`	int64	提交到仓库的总代码行数。

示例

请求示例

curl -X POST "${HOST}/openapi/v1/statistics/repo-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"],
    "sort_by": "ai_contribution_rate",
    "order": "desc",
    "page": 1,
    "page_size": 100
  }'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "items": [
      {
        "repo_url": "https://git.example.com/org/trae-server",
        "metrics": {
          "ai_contribution_rate": 50.0,
          "ai_commit_lines": 10000,
          "non_ai_commit_lines": 10000,
          "total_commit_lines": 20000
        }
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 100,
      "total": 128,
      "total_pages": 2
    }
  }
}

错误码

若该接口的请求返回错误码，参考错误码文档进行排查。

文档对您有帮助吗?