请求量统计
查询最近24小时的API请求量统计。
提示:返回的数据截止至上一个小时或更早时候,它与控制台中显示的数据相比可能有1个小时或更长的延迟。
获取权限
访问本接口必须由帐号所有者在控制台为凭据开通权限。
- 前往控制台-项目管理
 - 点击需要启用控制台API的凭据
 - 向下滑动至“控制台权限”
 - 在“指标和统计”中勾选所需要的权限:
    
- “允许访问请求量汇总统计”,汇总所有项目和凭据的请求量,包括已删除的
 - “允许访问指定项目的请求量统计”,使用
project参数过滤 - “允许访问指定凭据的请求量统计”,使用
credential参数过滤 
 - 点击“保存”按钮
 
请注意:已删除的项目或凭据无法单独查询(例如使用project或credential参数),但其请求量仍计入汇总统计中。
请求路径
/metrics/v1/stats
    参数
查询参数
- 
            
project指定项目ID以查看该项目的请求量统计。project与credential互斥。 - 
            
credential指定凭据ID以查看该凭据的请求量统计。credential与project互斥。 
请求示例
curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your_api_host/metrics/v1/stats'请将your_token替换为你的JWT身份认证,将your_api_host替换为你的API Host
返回数据
返回数据是JSON格式并进行了Gzip压缩。
{
  "metadata": {
    "tag": "dcd6183920ebf9f5aa3fd066ed68e61b"
  },
  "asOf": "2025-05-12T02:59Z",
  "success": [
    {
      "api": "Weather",
      "hours": [
        482,
        475,
        520,
        465,
        481,
        485,
        477,
        471,
        518,
        448,
        462,
        461,
        441,
        441,
        512,
        441,
        441,
        441,
        486,
        511,
        582,
        543,
        551,
        525
      ]
    },
    {
      "api": "Geo",
      "hours": [
        20,
        16,
        0,
        15,
        17,
        18,
        18,
        15,
        0,
        4,
        2,
        20,
        0,
        0,
        0,
        0,
        0,
        0,
        17,
        40,
        29,
        21,
        26,
        39
      ]
    },
    {
      "api": "WeatherAlert",
      "hours": [
        436,
        643,
        460,
        507,
        527,
        957,
        716,
        700,
        687,
        1014,
        706,
        557,
        559,
        799,
        280,
        464,
        452,
        764,
        472,
        488,
        496,
        806,
        479,
        556
      ]
    },
    {
      "api": "WeatherIndices",
      "hours": [
        16,
        15,
        0,
        9,
        17,
        16,
        14,
        13,
        0,
        0,
        0,
        10,
        0,
        0,
        0,
        0,
        0,
        0,
        17,
        34,
        29,
        19,
        26,
        29
      ]
    },
    {
      "api": "AirQuality",
      "hours": [
        16,
        15,
        0,
        9,
        17,
        16,
        14,
        13,
        0,
        0,
        0,
        10,
        0,
        0,
        0,
        0,
        0,
        0,
        17,
        34,
        29,
        19,
        26,
        29
      ]
    }
  ],
  "errors": [
    {
      "api": "Weather",
      "hours": [
        3,
        1,
        4,
        3,
        3,
        3,
        3,
        3,
        4,
        0,
        1,
        3,
        3,
        3,
        4,
        3,
        3,
        3,
        3,
        3,
        4,
        3,
        3,
        3
      ]
    },
    {
      "api": "WeatherAlert",
      "hours": [
        0,
        0,
        0,
        0,
        0,
        1,
        1,
        1,
        1,
        0,
        1,
        0,
        0,
        0,
        0,
        4,
        2,
        1,
        1,
        1,
        1,
        1,
        1,
        1
      ]
    }
  ]
}
- 
        
asOf当前数据的截止日期。 - 
        
success.api成功请求的API名称。 - 
        
success.hours最近24小时每小时的成功请求量,结束时间以asOf为准。例如 asOf=2025-03-20T09:59Z,则数组中的最后一条数据代表09:00 ~ 09:59(UTC)的请求量。 - 
        
errors.api错误请求的API名称。 - 
        
errors.hours最近24小时每小时的错误请求量,结束时间以asOf为准。例如 asOf=2025-03-20T09:59Z,则数组中的最后一条数据代表09:00 ~ 09:59(UTC)的请求量。 
API名称
| Code | 描述 | 
|---|---|
| Geo | 地理信息 | 
| Weather | 天气 | 
| MinutelyForecast | 分钟降水预报 | 
| WeatherIndices | 天气指数 | 
| WeatherAlert | 天气预警 | 
| AirQuality | 空气质量 | 
| TimeMachine | 时光机 | 
| Storm | 热带气旋(台风) | 
| Astronomy | 天文 | 
| SolarIrradiation | 太阳辐照 | 
| Ocean | 海洋 | 
| Console | 控制台API |