统计接口（新版）
更新时间：2024-05-15
接口
本接口用于查询用户或域名的统计指标信息。
| Method | Path | 说明 |
|---|---|---|
| POST | /v2/abroad/stat/query | 所有统计数据的路径，不同的统计指标由post参数中的metric指定。 |
默认接口请求频率限制：30次/秒。
默认请求体（Request Body）
所有metric支持的参数以此进行扩展。
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| metric | 必选 | String | 示例：src_httpcode。更多metric参数值请查看本页面中对应接口metric值 |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC时间 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为endTime前推24小时，UTC时间。300s粒度可查询最近90天数据，其他粒度可查询最近180天数据 |
| period | 可选 | Long | 查询结果的粒度，单位秒，可选值为300、3600、86400，默认为300 |
| key_type | 可选 | Long | 标识key的内容，0=>域名，1=>用户id，默认0 |
| key | 可选 | list<String> | 域名或用户Id |
| groupBy | 可选 | String | 返回结果聚合粒度，key => 根据key聚合， 空 => 返回整体结果，默认返回整体 |
默认响应体（Response Body）
所有metric的响应结果以此扩展。
| 参数 | 类型 | 说明 |
|---|---|---|
| status | String | 正常返回的时候为"ok" |
| details | list<Details> | list类型 |
| count | Long | list的长度 |
Details 内容
| 参数 | 类型 | 说明 |
|---|---|---|
| timestamp | Timestamp | 时间点 UTC时间 |
| key | String | 聚合粒度（groupBy）：key => key，其他 => total |
| ... | Object | 扩展字段，metric对应的统计指标 |
状态码查询接口
回源状态码查询
metric：src_httpcode
响应体扩展字段：
| 参数 | 类型 | 说明 |
|---|---|---|
| counters | list<KvCounter> | HTTP状态码计数 |
KvCounter内容
| 参数 | 类型 | 说明 |
|---|---|---|
| name | Long | HTTP状态码 |
| count | Long | 统计计数 |
请求示例
POST /v2/abroad/stat/query HTTP/1.1
Host: cdn.baidubce.com
{
"startTime": "2024-05-08T16:00:00Z",
"endTime": "2024-05-08T16:10:00Z",
"period": 300,
"key_type": 0,
"key": [
"www.baidu.com"
],
"groupBy": "",
"metric": "src_httpcode"
}返回示例
HTTP/1.1 200 OK
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
{
"status": "ok",
"details": [
{
"counters": [
{
"name": 200,
"count": 43605
},
{
"name": 206,
"count": 4
},
{
"name": 301,
"count": 84
}
],
"timestamp": "2024-05-08T16:00:00Z",
"key": "total"
},
{
"counters": [
{
"name": 200,
"count": 45404
},
{
"name": 301,
"count": 75
},
{
"name": 304,
"count": 217
}
],
"timestamp": "2024-05-08T16:05:00Z",
"key": "total"
}
],
"count": 2
}