GET管理接口
事件量趋势
事件量随时间的变化。`data` 是总量，永远返回；给了 `group_by` 时额外返回按维度 拆开的 `series`，供堆叠图使用。两者并列而不是二选一——堆叠图的包络线就是总量。 空桶补零，日桶按 `tz_offset_minutes` 断在查看者的午夜而不是 UTC 的午夜。
URL
/api/v1/admin/projects/{projectKey}/events/stats/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 | 否 | |
| event_name | string | 否 | 只看某一个事件；不传则是全部事件的总量。 |
| group_by | event | platform | region | 否 | 额外按维度拆出多条序列。 |
| limit | integer | 否 | 拆分序列数上限。 |
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
该接口无需请求体。
响应示例
200 响应
{
"start_time": 0,
"end_time": 0,
"granularity": "hour",
"tz_offset_minutes": 0,
"event_name": "string",
"group_by": "event",
"data": [
{
"bucket": 1760000000,
"count": 42
}
],
"series": [
{
"key": "string",
"data": [
{
"bucket": 1760000000,
"count": 42
}
]
}
]
}GET
