分域名PV查询下载PDF文档

接口地址

请求URL: stat/pv/eachDomain (GET)

接口请求域名: cdn.api.baishan.com
接口版本: v2

接口描述

用于查询多个加速域名，并返回每个加速域名的PV(Page View)数据。当前只统计状态码为1XX、2XX和304并且Content-Type为"text/html", "text/asp", “text/plain”这三种类型的请求。

数据统计的时间粒度默认为5分钟。接口调用频率限制见响应头部（Response Header）。

输入参数

公有参数：用户的 token 可向值班同事获取。

请求参数(GET)

参数添加到在url的query部分，例如: ?key1=value1&key2=value2。

参数名	数据类型	是否必须	说明
domains	string	是	需要查询的加速域名。单次请求最多查询10个加速域名，多个加速域名用英文逗号(,)分隔。查询多个加速域名时，返回各个加速域名的PV(Page View)数据。
start_time	string	是	查询起始时间，格式：YYYY-mm-dd或者YYYY-mm-dd HH:ii 参数值：2020-06-01，代表以 2020-06-01 00:00:00作为起始时间。开始时间必须大于当前时间，起始时间与结束时间间隔小于等于31天。
end_time	string	是	查询结束时间，格式：YYYY-mm-dd或者YYYY-mm-dd HH:ii 参数值：2020-06-01，代表以 2020-06-01 23:59:59作为结束时间。结束时间必须大于起始时间，起始时间与结束时间间隔小于等于31天。
stat_is_forward	string	否	查询时间点的含义： `0`：时间点后指向，如2020-06-01 10:00 代表 [2020-06-01 10:00:00, 2020-06-01 10:04:59] `1`：时间点前指向，如2020-06-01 10:05 代表 [2020-06-01 10:00:00, 2020-06-01 10:04:59] 不填充时，默认值为0。
grad	string	否	统计数据时间粒度: `minute5`：5分钟粒度 `hour`：小时粒度 `day`：天粒度不填充时，默认为minute5。
query_area	string	否	指定查询范围： `all`：查询国内+国外 `cn`：查询国内 `abroad`：查询国外不填充时，默认为国内+国外。

调用示例

//请求需要经过URL编码处理。
curl -X GET "https://cdn.api.baishan.com/v2/stat/pv/eachDomain?token=xxx\
&domains=example.com\
&start_time=2020-06-01%2010:00\
&end_time=2020-06-01%2011:00"

返回示例

json格式

正确示例
{
    "code": 0,
    "data": {
        "example.com": {
            "domain": "example.com",
            "data": [
                [
                    1500393600,//时间戳，返回时间戳按照升序排序。
                    10 //PV的请求个数。
                ],
                [
                    1500393900,
                    22
                ],
                [
                    1500394200,
                    12
                ],
                [
                    1500479400,
                    19
                ]
            ]
        }
    }
}

错误示例
{
    "code": 400101,
    "message": "domain(life.com) is invalid"
}

响应头部(Response Header)

HTTP/1.0 200 OK
Api-Id:                272604011
Content-Type:          application/json; charset=utf-8
X-Ratelimit-Grad:      minute
X-Ratelimit-Limit:     150
X-Ratelimit-Remaining: 150
X-Retry-After:         16

http状态码说明

错误状态码	说明
404	您输入的 URL 错误
401	鉴权错误，您的 token 可能是不对的
400	请求参数有误
200	执行成功，返回请求的数据
5xx	请联系值班同事

分域名PV查询 下载PDF文档