返回 API 目录
GET管理接口

查询客户端系统版本分布

统计调用方的操作系统版本，按次数降序返回，用于判断还有多少用户停留在旧系统上。与「客户端版本分布」的区别：那张表回答装的是本产品哪个版本，这张回答跑在什么系统上。平台取显式声明或 User-Agent 推断，版本明细取 platform_version（也接受混写在 platform 里的形式，服务端会拆开）。未上报版本的流量落在 platform_version 为空串的桶里，照常计入 total。

URL

/api/v1/admin/projects/{projectKey}/stats/requests/platform-versions

鉴权方式

需要管理员 JWT 或 API Key，二者等价（Authorization: Bearer <token>）

请求参数

Path 参数

名称类型必填说明
projectKeystring是项目主键 project_key（大小写不敏感）

Query 参数

名称类型必填说明
start_timeinteger否Unix 时间戳（秒）
end_timeinteger否Unix 时间戳（秒）
limitinteger否最多返回多少个系统版本桶，其余计入长尾

Header 参数

名称类型必填说明
Authorizationstring是Bearer <管理员 JWT 或 API Key>

该接口无需请求体。

响应示例

200 客户端系统版本分布

{
  "start_time": 1760000000,
  "end_time": 1762000000,
  "total": 9600,
  "data": [
    {
      "platform": "WINDOWS",
      "platform_version": "11",
      "count": 5120
    },
    {
      "platform": "WINDOWS",
      "platform_version": "10",
      "count": 2380
    },
    {
      "platform": "LINUX",
      "platform_version": "ubuntu 24.04",
      "count": 1400
    },
    {
      "platform": "MACOS",
      "platform_version": "",
      "count": 700
    }
  ]
}
GET

Try It Out

请求 URL 预览

/api/v1/admin/projects/verhub/stats/requests/platform-versions?start_time=1760000000&end_time=1762000000&limit=30