GET管理接口

事件活跃热力图

事件量折到星期 × 小时的网格，固定 168 格（含无数据的空格）。折叠按每条上报**来源国家**的代表时区进行，回答的是「用户在当地几点活跃」； `tz_offset_minutes` 只是无法定位的来源的回退值。这与趋势图的口径不同—— 趋势图用统一的查询者时区画绝对时间轴。

URL

/api/v1/admin/projects/{projectKey}/events/stats/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）。
event_name	string	否

Header 参数

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

该接口无需请求体。

200 响应

{
  "start_time": 0,
  "end_time": 0,
  "tz_offset_minutes": 0,
  "data": [
    {
      "weekday": 0,
      "hour": 0,
      "count": 0
    }
  ]
}

GET