GET管理接口

查询接口请求统计概览

按项目返回指定时间范围内的公开接口请求总数,以及按接口、平台、地区的分组汇总。未指定时间范围时默认统计最近 7 天。

URL

/api/v1/admin/projects/{projectKey}/stats/requests/overview

鉴权方式

需要管理员 JWT 或 API Key,二者等价(Authorization: Bearer <token>)

请求参数

Path 参数

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

Query 参数

名称类型必填说明
start_timeintegerUnix 时间戳(秒)
end_timeintegerUnix 时间戳(秒)

Header 参数

名称类型必填说明
AuthorizationstringBearer <管理员 JWT 或 API Key>

该接口无需请求体。

响应示例

200 统计概览

{
  "start_time": 1760000000,
  "end_time": 1762000000,
  "total": 12840,
  "by_endpoint": [
    {
      "endpoint": "VERSION_CHECK_UPDATE",
      "count": 8210
    },
    {
      "endpoint": "VERSION_LATEST",
      "count": 3120
    }
  ],
  "by_platform": [
    {
      "platform": "WINDOWS",
      "count": 9020
    },
    {
      "platform": "MAC",
      "count": 2400
    }
  ],
  "by_region": [
    {
      "region": "CN",
      "count": 9600
    },
    {
      "region": "US",
      "count": 2100
    },
    {
      "region": "UNKNOWN",
      "count": 1140
    }
  ],
  "by_province": [
    {
      "code": "440000",
      "name": "广东省",
      "count": 4200
    },
    {
      "code": "310000",
      "name": "上海市",
      "count": 2600
    },
    {
      "code": "210000",
      "name": "辽宁省",
      "count": 1800
    }
  ]
}
GET

Try It Out

请求 URL 预览

/api/v1/admin/projects/verhub/stats/requests/overview?start_time=1760000000&end_time=1762000000