统计接口（新版）
更新时间：2025-08-21
接口
本接口用于查询用户或域名的统计指标信息。
| 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 | 统计计数 |
请求示例
JSON
1POST /v2/abroad/stat/query HTTP/1.1
2Host: cdn.baidubce.com
3
4{
5 "startTime": "2024-05-08T16:00:00Z",
6 "endTime": "2024-05-08T16:10:00Z",
7 "period": 300,
8 "key_type": 0,
9 "key": [
10 "www.baidu.com"
11 ],
12 "groupBy": "",
13 "metric": "src_httpcode"
14}返回示例
JSON
1HTTP/1.1 200 OK
2Content-Type: application/json;utf-8
3x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
4{
5 "status": "ok",
6 "details": [
7 {
8 "counters": [
9 {
10 "name": 200,
11 "count": 43605
12 },
13 {
14 "name": 206,
15 "count": 4
16 },
17 {
18 "name": 301,
19 "count": 84
20 }
21 ],
22 "timestamp": "2024-05-08T16:00:00Z",
23 "key": "total"
24 },
25 {
26 "counters": [
27 {
28 "name": 200,
29 "count": 45404
30 },
31 {
32 "name": 301,
33 "count": 75
34 },
35 {
36 "name": 304,
37 "count": 217
38 }
39 ],
40 "timestamp": "2024-05-08T16:05:00Z",
41 "key": "total"
42 }
43 ],
44 "count": 2
45}