GET管理接口
查询请求活跃度热力图
把范围内的请求量折叠到「星期 × 小时」网格上，用于观察用户在其当地一周内的访问高峰时段。固定返回 168 个格子，无流量的格子为 0。折叠按每条请求的来源当地时区进行（由国家码推定，中国精确为 UTC+8，跨时区国家取代表时区近似）；tz_offset_minutes 仅作无法定位来源（UNKNOWN/LOCAL/表外国家）时的兜底，省略即按 UTC 兜底。
URL
/api/v1/admin/projects/{projectKey}/stats/requests/heatmap鉴权方式
需要管理员 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）。 |
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
该接口无需请求体。
响应示例
200 活跃度热力图
{
"start_time": 1760000000,
"end_time": 1762000000,
"tz_offset_minutes": 480,
"data": [
{
"weekday": 1,
"hour": 9,
"count": 412
},
{
"weekday": 1,
"hour": 10,
"count": 508
}
]
}GET
