请求量统计
查询最近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 |