统计接口（旧版）

更新时间：2020-12-14

接口描述

各项统计指标查询

/v2/stat/[metric] 默认接口请求频率限制：30次/秒。

pv/qps查询接口

Method	Path	说明
GET	/v2/stat/pv	查询域名pv请求量

URL参数：

参数	可选	类型	说明
domain	可选	String	查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名pv数之和
endTime	可选	Timestamp	查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度90天
startTime	可选	Timestamp	查询的时间范围起始值，默认为endTime前推24小时，UTC时间
period	可选	Int	查询结果的粒度，单位秒，可选值为300,3600,86400 默认为300
withRegion	可选	Bool	查询客户端访问分布详情，当包含此项时，结果中details的记录数不能超过64个
prov	可选	String	查询的省份全拼，默认为空，查询全国数据。不可以与withRegion同时使用。
isp	可选	String	查询的运营商代码，默认为空，查询所有运营商数据。不可以与withRegion同时使用。

响应体 (Response Body)

参数	类型	说明
details	list类型，参见下表PvDetails内容。	数据详情

PvDetails内容：

参数	类型	说明
timestamp	Timestamp	时间点，UTC时间
pv	Int	统计时间段内的请求量
qps	Int	统计时间段内的平均qps
regions	list类型，参见下表PvRegionData内容	客户端访问分布数据，当请求包含withRegion参数时包含此项

PvRegionData内容：

参数	类型	说明
location	String	客户端所在省份、地区
isp	String	客户端所属运营商
pv	Int	统计时间段内的请求量
qps	Int	统计时间段内的平均qps

请求示例

GET /v2/stat/pv?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
Host: cdn.baidubce.com

返回示例

HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
  "details":
  [
    {"timestamp":"2016-10-13T00:00:00Z","pv":1998202,"qps":556},
    {"timestamp":"2016-10-13T01:00:00Z","pv":2169932,"qps":603}
  ]
}

带宽&流量查询接口

Method	Path	说明
GET	/v2/stat/flow	查询域名流量记录

URL参数：

参数	可选	类型	说明
domain	可选	String	查询的域名，可多个域名用逗号分隔，返回内容为所有域名的数据之和，如不指定则返回该用户所有域名流量之和
endTime	可选	Timestamp	查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天
startTime	可选	Timestamp	查询的时间范围起始值，默认为endTime前推24小时，UTC时间
period	可选	Int	查询结果的粒度，单位秒，可选值为300,3600,86400, 默认为300
withRegion	可选	Bool	查询客户端访问分布详情，当包含此项时，结果中details的记录数不能超过64个
prov	可选	String	查询的省份全拼，默认为空，查询全国数据。不可以与withRegion同时使用。
isp	可选	String	查询的运营商代码，默认为空，查询所有运营商数据。不可以与withRegion同时使用。
level	可选	String	查询边缘节点或者中心节点带宽。不可以与withRegion同时使用，可以填写“edge”或者“internal”。

响应体 (Response Body)

参数	类型	说明
details	list参见下表	数据详情

FlowDetail内容：

参数	类型	说明
timestamp	Timestamp	时间点，UTC时间
flow	Int	统计时间段内的传输字节数
bps	Int	统计时间段内的平均bps
regions	list参见下表	客户端访问分布数据，当请求中的withRegion为true时包含此项

FlowRegionData内容：

参数	类型	说明
location	String	客户端所在省份、地区
isp	String	客户端所属运营商
flow	Int	统计时间段内的传输字节数
bps	Int	统计时间段内的平均bps

请求示例

GET /v2/stat/flow?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
Host: cdn.baidubce.com

响应示例

HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
  "details":
  [
    {"timestamp":"2016-10-13T00:00:00Z","flow":42652354694,"bps":94783010},
    {"timestamp":"2016-10-13T01:00:00Z","flow":45766298297,"bps":101702885}
  ]
}

回源流量查询接口

Method	Path	说明
GET	/v2/stat/srcflow	查询域名回源流量记录

URL参数：

参数	可选	类型	说明
domain	可选	String	查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名回源流量之和
endTime	可选	Timestamp	查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天
startTime	可选	Timestamp	查询的时间范围起始值，默认为endTime前推24小时，UTC时间
period	可选	Int	查询结果的粒度，单位秒，可选值为300,3600,86400, 默认为300

响应体 (Response Body)

参数	类型	说明
details	list参见下表	数据详情

请求示例

GET /v2/stat/srcflow?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
Host: cdn.baidubce.com

响应示例

HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
  "details":
  [
    {"timestamp":"2016-10-13T00:00:00Z","flow":741119469,"bps":1646932},
    {"timestamp":"2016-10-13T01:00:00Z","flow":905548590,"bps":2012330}
  ]
}

字节命中率查询接口

Method	Path	说明
GET	/v2/stat/hitrate	查询字节命中率

URL参数：

参数	是否可选	类型	说明
domain	可选	String	查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名字节命中率的平均值
endTime	可选	Timestamp	查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天
startTime	可选	Timestamp	查询的时间范围起始值，默认为endTime前推24小时，UTC时间
granularity	可选	Int	查询结果的粒度，单位秒，可选值为60,300,3600 默认为300

响应体 (Response Body)

参数	类型	说明
details	list类型，HitRateDetails内容项详细解释： - timestamp：Timestamp类型，表示时间点。 - hitrate：Double类型，表示统计时间段内的字节命中率。	数据详情

请求示例

GET /v2/stat/hitrate?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
Host: cdn.baidubce.com

响应示例

HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
  "details":
  [
    {"timestamp":"2016-10-13T00:00:00Z","hitrate":0.98262418395615},
    {"timestamp":"2016-10-13T01:00:00Z","hitrate":0.98021363702777}
  ]
}

状态码统计查询接口

Method	Path	说明
GET	/v2/stat/httpcode	查询域名状态码统计

URL参数：

参数	是否可选	类型	说明
domain	可选	String	查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名状态码计数
endTime	可选	Timestamp	查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天
startTime	可选	Timestamp	查询的时间范围起始值，默认为endTime前推24小时，UTC时间
period	可选	Int	查询结果的粒度，单位秒，可选值为300,3600,86400, 默认为300
withRegion	可选	Bool	查询客户端访问分布详情，当包含此项时，结果中details的记录数不能超过64个
prov	可选	String	查询的省份全拼，默认为空，查询全国数据。不可以与withRegion同时使用。
isp	可选	String	查询的运营商代码，默认为空，查询所有运营商数据。不可以与withRegion同时使用。

响应体（Response Body）

参数	类型	说明
details	list参见下表解释	数据详情

HttpCodeDetails内容：

参数	类型	说明
timestamp	Timestamp	时间点，UTC时间
counters	list参见下表	HTTP状态码计数
regions	list参见下表解释	按客户端访问地域分布的数据详情

HttpCodeRegionData内容：

参数	类型	说明
location	String	客户端所在省份、地区
isp	String	客户端所属运营商
counters	list参见下表解释	HTTP状态码计数

KvCounter内容：

参数	类型	说明
name	String	统计项
value	Int	统计计数

请求示例

GET /v2/stat/httpcode?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
Host: cdn.baidubce.com

返回示例

HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
 
{
  "details":
  [
    {
      "timestamp":"2016-10-13T00:00:00Z",
      "counters": [
        {"name":"504","value": 12},
        {"name":"502", "value": 18},
        {"name":"502", "value": 24},
        {"name": "206", "value": 66},
        {"name": "200", "value":1759884},
        {"name": "304", "value": 259405},
        {"name": "499", "value": 602},
        {"name": "404", "value": 1902}
    ]
    },
    {
      "timestamp":"2016-10-13T01:00:00Z",
      "counters": [
        {"name":"504","value": 12},
        {"name":"502", "value": 18},
        {"name":"502", "value": 24},
        {"name": "206", "value": 66},
        {"name": "200", "value":1759884},
        {"name": "304", "value": 259405},
        {"name": "499", "value": 602},
        {"name": "404", "value": 1902}
    ],
    }
  ]
}

TopN url查询接口

Method	Path	说明
GET	/v2/stat/topn/url	查询top100 url列表

url参数：

参数	可选	类型	说明
domain	可选	String	查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名的top100 url列表
endTime	可选	Timestamp	查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天
startTime	可选	Timestamp	查询的时间范围起始值，默认为endTime前推24小时，UTC时间
period	可选	Int	查询结果的粒度，单位秒，可选值为3600,86400, 默认为3600

响应体（Response Body）

参数	类型	说明
details	list类型，TopUrlDetails内容项解释如下： - timestamp：Timestamp类型，表示时间点，UTC时间。 - counters：list类型，表示Top100 url统计。KvCounter内容项解释如下： - name：String类型，表示统计项。 - value：Int类型，表示统计计数。	数据详情

请求示例：

GET /v2/stat/topn/url?domain=my.test.com&endTime=2016-10-22T03%3A01%3A00Z&period=3600&startTime=2016-10-22T01%3A57%3A00Z HTTP/1.1
Host: cdn.baidubce.com

响应示例：

HTTP/1.1 200 OK
Content-Length: 7113
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
 
{
    "details": [
    {
      "timestamp": "2016-10-22T02:00:00Z",
      "counters":
      [
        {"name":"http://my.test.com/path/to/file1.png", "value": 2551},
        {"name":"http://my.test.com/path/to/file2.gif", "value": 1195},
        {"name":"http://my.test.com/path/to/file3.jpg", "value": 932},
        {"name":"http://my.test.com/path/to/file4.mp4", "value": 846},
        {"name":"http://my.test.com/path/to/file5.css", "value": 544},
        {"name":"http://my.test.com/path/to/file6.js", "value": 326},
        {"name":"http://my.test.com/path/to/file7.flv", "value": 122},
        {"name":"http://my.test.com/path/to/file8.zip", "value": 116},
        {"name":"http://my.test.com/path/to/file9.doc", "value": 98},
        {"name":"http://my.test.com/path/to/file10.mp3", "value": 76},
        {"name":"http://my.test.com/path/to/file11.pdf", "value": 18}
      ]
    },
    {
    "timestamp": "2016-10-22T03:00:00Z",
    "counters":
    [
      {"name":"http://my.test.com/path/to/file1.png", "value": 2382},
      {"name":"http://my.test.com/path/to/file2.gif", "value": 1245},
      {"name":"http://my.test.com/path/to/file3.jpg", "value": 923},
      {"name":"http://my.test.com/path/to/file4.mp4", "value": 811},
      {"name":"http://my.test.com/path/to/file5.css", "value": 532},
      {"name":"http://my.test.com/path/to/file6.js", "value": 423},
      {"name":"http://my.test.com/path/to/file7.flv", "value": 209},
      {"name":"http://my.test.com/path/to/file8.zip", "value": 155},
      {"name":"http://my.test.com/path/to/file9.doc", "value": 84},
      {"name":"http://my.test.com/path/to/file10.mp3", "value": 80},
      {"name":"http://my.test.com/path/to/file11.pdf", "value": 32}
     ]
    }
  ]
}

TopN referer查询接口

Method	Path	说明
GET	/v2/stat/topn/referer	查询top100 referer

URL参数：

参数	可选	类型	说明
domain	可选	String	查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名的top100 referer
endTime	可选	Timestamp	查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天
startTime	可选	Timestamp	查询的时间范围起始值，默认为endTime前推24小时，UTC时间
period	可选	Int	查询结果的粒度，单位秒，可选值为3600,86400, 默认为3600

响应体（Response Body）

参数	类型	说明
details	list类型，TopRefererDetails内容项详细解释如下： - timestamp：Timestamp类型，表示时间点，UTC时间。 - counters：list类型，表示Top 100 refer统计计数。KvCounter内容项解释如下： - name：String类型，表示统计项。 - value：Int类型，表示统计计数。	数据详情

请求示例：

GET /v2/stat/topn/referer?domain=my.test.com&endTime=2016-10-22T02%3A01%3A00Z&period=3600&startTime=2016-10-22T01%3A57%3A00Z HTTP/1.1
Host: cdn.baidubce.com

响应示例：

HTTP/1.1 200 OK
Content-Length: 180
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
 
{
  "details":
  [
    {
      "timestamp":"2016-10-22T02:00:00Z",
      "counters":
      [
        {"name":"-", "value":53687},
        {"name":"i1.my.test.com", "value":752},
        {"name":"i2.my.test.com", "value":393},
        {"name":"i3.my.test.com", "value":1}
      ]
    }
  ]
}

uv查询接口

Method	Path	说明
GET	/v2/stat/uv	查询域名uv请求量

URL参数：

参数	可选	类型	说明
domain	可选	String	查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名uv之和
endTime	可选	Timestamp	查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度90天
startTime	可选	Timestamp	查询的时间范围起始值，默认为endTime前推24小时，UTC时间
period	可选	Int	查询结果的粒度，单位秒，可选值为3600,86400, 默认为3600
withRegion	可选		查询客户端访问分布详情，当包含此项时，结果中details的记录数不能超过64个

响应体

参数	类型	说明
details	list	数据详情

UvDetails内容

参数	类型	说明
timestamp	Timestamp	时间点，UTC时间
uv	Int	统计时间段内的请求量
regions	list	客户端访问分布数据，当请求包含withRegion参数时包含此项

UvRegionData内容

参数	类型	说明
location	String	客户端所在省份、地区
isp	String	客户端所属运营商
uv	Int	统计时间段内的请求量

请求示例：

GET /v2/stat/uv?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
Host: cdn.baidubce.com

响应示例：

HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
  "details":
  [
    {"timestamp":"2016-10-13T00:00:00Z","uv":1998202},
    {"timestamp":"2016-10-13T01:00:00Z","uv":2169932}
  ]
}

平均速率查询接口

Method	Path	说明
GET	/v2/stat/avgspeed	查询平均速率记录

URL参数：

参数	可选	类型	说明
domain	可选	String	查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名平均速率的均值
endTime	可选	Timestamp	查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天
startTime	可选	Timestamp	查询的时间范围起始值，默认为endTime前推24小时，UTC时间
period	可选	Int	查询结果的粒度，单位秒，可选值为300,3600,86400, 默认为3600

响应体：

参数	类型	说明
details	list<AvgSpeedDetails>	数据详情

AvgSpeedDetails内容

参数	类型	说明
timestamp	Timestamp	时间点，UTC时间
avgspeed	Int	统计时间段内的平均速率

请求示例：

GET /v2/stat/avgspeed?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
Host: cdn.baidubce.com

响应示例：

HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
  "details":
  [
    {"timestamp":"2016-10-13T00:00:00Z","avgspeed":741119469},
    {"timestamp":"2016-10-13T01:00:00Z","avgspeed":905548590}
  ]
}

统计接口（新版）

上行流量统计

百度智能云

内容分发网络 CDN

内容分发网络 CDN

统计接口（旧版）

接口描述

pv/qps查询接口

带宽&流量查询接口

回源流量查询接口

字节命中率查询接口

状态码统计查询接口

TopN url查询接口

TopN referer查询接口

uv查询接口

平均速率查询接口