请求量统计

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

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

获取权限#

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

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

请注意：已删除的项目或凭据无法单独查询（例如使用project或credential参数），但其请求量仍计入汇总统计中。

请求路径#

GET /metrics/v1/stats

参数#

查询参数

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

请求示例#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/metrics/v1/stats?project=project_123&cred=cred_abc'

请将your_token替换为你的JWT身份认证，将your_api_host替换为你的API Host

试一下

返回数据#

{
  "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
      ]
    }
  ]
}
  • metadata object 当前响应的元数据
    • tag string 数据唯一标识
  • asOf date-time 当前数据的截止日期
  • success array 成功的请求数据
    • api string 成功请求的API名称
    • hours array 最近24小时每小时的成功请求量，结束时间以asOf为准。例如 asOf=2025-03-20T09:59Z，则数组中的最后一条数据代表09:00 ～ 09:59（UTC）的请求量
  • errors array 错误的请求数据
    • api string 错误请求的API名称
    • hours array 最近24小时每小时的错误请求量，结束时间以asOf为准。例如 asOf=2025-03-20T09:59Z 则数组中的最后一条数据代表09:00 ～ 09:59（UTC）的请求量