GET管理接口
查询接口请求时间序列
按小时或按天返回请求数序列。统计始终以小时为最小粒度存储,granularity=day 时在查询阶段汇总;范围内无请求的时间桶以 0 返回,便于直接绘制曲线。granularity=day 时按 tz_offset_minutes 所指时区的午夜切分,返回的 bucket 即该本地日开始的时刻。
URL
/api/v1/admin/projects/{projectKey}/stats/requests/timeseries鉴权方式
需要管理员 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 | 否 | |
| endpoint | PROJECT_DETAIL | VERSION_LIST | VERSION_LATEST | VERSION_LATEST_PREVIEW | VERSION_BY_VERSION | VERSION_CHECK_UPDATE | ANNOUNCEMENT_LIST | ANNOUNCEMENT_LATEST | FEEDBACK_SUBMIT | LOG_UPLOAD | EVENT_INGEST | 否 | 仅统计指定接口,省略则统计全部接口 |
| group_by | endpoint | platform | 否 | 额外按维度拆出多条序列(响应的 `series`),用于堆叠面积图。 总量 `data` 不受影响,始终返回。只开放低基数的枚举维度: 自由文本维度拆出来的序列数没有上界。 |
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
该接口无需请求体。
响应示例
200 请求数时间序列
{
"start_time": 1760000000,
"end_time": 1760086400,
"granularity": "hour",
"tz_offset_minutes": 480,
"endpoint": "VERSION_CHECK_UPDATE",
"data": [
{
"bucket": 1760000000,
"count": 320
},
{
"bucket": 1760003600,
"count": 287
}
]
}GET
