GET管理接口
查询客户端版本分布
统计客户端调用 check-update 时上报的 current_version，按上报次数降序返回，用于判断线上最主流的版本。版本号按客户端原文记录，未发布过的版本也会如实出现。
URL
/api/v1/admin/projects/{projectKey}/stats/requests/client-versions鉴权方式
需要管理员 JWT 或 API Key，二者等价（Authorization: Bearer <token>）
请求参数
Path 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| projectKey | string | 是 | 项目主键 project_key（大小写不敏感） |
Query 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| start_time | integer | 否 | Unix 时间戳（秒） |
| end_time | integer | 否 | Unix 时间戳（秒） |
| limit | integer | 否 | 最多返回多少个版本，其余计入长尾 |
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
该接口无需请求体。
响应示例
200 客户端版本分布
{
"start_time": 1760000000,
"end_time": 1762000000,
"total": 8210,
"data": [
{
"version": "2.3.0",
"count": 5120
},
{
"version": "2.2.1",
"count": 2380
}
]
}GET
