GET管理接口
查询版本采纳曲线
各客户端版本的上报量随时间变化，用于看新版本推广得多快、旧版本退得多干净。只返回区间内总量最大的 limit 个版本；被截掉的尾巴不单独成序列，用 client-versions 的 total 减去各序列即可还原。
URL
/api/v1/admin/projects/{projectKey}/stats/requests/version-adoption鉴权方式
需要管理员 JWT 或 API Key，二者等价（Authorization: Bearer <token>）
请求参数
Path 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| projectKey | string | 是 | 项目主键 project_key（大小写不敏感） |
Query 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| start_time | integer | 否 | Unix 时间戳（秒） |
| end_time | integer | 否 | Unix 时间戳（秒） |
| tz_offset_minutes | integer | 否 | 相对 UTC 的分钟偏移，即浏览器的 `-new Date().getTimezoneOffset()`。 统计桶按 UTC 小时存储，但「几点最忙」问的是受众的墙上时间，因此 「星期 × 小时」与「按天」的折叠都以该偏移为准。省略时为 0（等同 UTC）。 |
| granularity | hour | day | 否 | 聚合粒度，默认按天 |
| limit | integer | 否 | 最多返回多少条版本序列 |
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
该接口无需请求体。
响应示例
200 版本采纳曲线
{
"start_time": 1760000000,
"end_time": 1762000000,
"granularity": "day",
"tz_offset_minutes": 480,
"series": [
{
"version": "2.3.0",
"data": [
{
"bucket": 1760000000,
"count": 120
},
{
"bucket": 1760086400,
"count": 340
}
]
},
{
"version": "2.2.1",
"data": [
{
"bucket": 1760000000,
"count": 480
},
{
"bucket": 1760086400,
"count": 260
}
]
}
]
}GET
