请求量统计

平台: API

查询最近24小时的API请求量统计。

提示:返回的数据截止至上一个小时或更早时候,它与控制台中显示的数据相比可能有1个小时或更长的延迟。

获取权限

访问本接口必须由帐号所有者在控制台为凭据开通权限。

  1. 前往控制台-项目管理
  2. 点击需要启用控制台API的凭据
  3. 向下滑动至“控制台权限”
  4. 在“指标和统计”中勾选所需要的权限:
    • “允许访问请求量汇总统计”,汇总所有项目和凭据的请求量,包括已删除的
    • “允许访问指定项目的请求量统计”,使用project参数过滤
    • “允许访问指定凭据的请求量统计”,使用credential参数过滤
  5. 点击“保存”按钮

请注意:已删除的项目或凭据无法单独查询(例如使用projectcredential参数),但其请求量仍计入汇总统计中。

请求路径

/metrics/v1/stats

参数

查询参数

  • project指定项目ID以查看该项目的请求量统计。projectcredential互斥。
  • credential指定凭据ID以查看该凭据的请求量统计。credentialproject互斥。

请求示例

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