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 参数

名称类型必填说明
projectKeystring项目主键 project_key(大小写不敏感)

Query 参数

名称类型必填说明
start_timeintegerUnix 时间戳(秒)
end_timeintegerUnix 时间戳(秒)
tz_offset_minutesinteger相对 UTC 的分钟偏移,即浏览器的 `-new Date().getTimezoneOffset()`。 统计桶按 UTC 小时存储,但「几点最忙」问的是受众的墙上时间,因此 「星期 × 小时」与「按天」的折叠都以该偏移为准。省略时为 0(等同 UTC)。
granularityhour | day
endpointPROJECT_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_byendpoint | platform额外按维度拆出多条序列(响应的 `series`),用于堆叠面积图。 总量 `data` 不受影响,始终返回。只开放低基数的枚举维度: 自由文本维度拆出来的序列数没有上界。

Header 参数

名称类型必填说明
AuthorizationstringBearer <管理员 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

Try It Out

请求 URL 预览

/api/v1/admin/projects/verhub/stats/requests/timeseries?start_time=1760000000&end_time=1762000000&tz_offset_minutes=480&granularity=hour