接口描述:调用本接口查询PV数据
请求方式:post
请求路径:/statistics/query-pv-data
使用说明:
- 单个用户一分钟限制调用10000次,并发不超过100;
- 单次查询输入域名的个数不能超过100个;
- 按时间粒度5分钟返回数据,数据延迟时间20分钟,可查询历史数据时间范围为最近183天,支持最大时间跨度31天
- 若查询结束时间不包含在该批次的最后一秒,默认end_time为该批次最后一秒,例如:时间粒度为1h,end_time设置为17:30对应的时间戳,此时end_time默认成17:59:59;
- 时间片统计数据均为前打点,假如time_stamp= "2021-10-13 00:00"对应的时间戳,表示统计的数据为时间区间[2021-10-13 00:00, 2021-10-13 00:05)
请求参数说明(json)
参数 | 类型 | 是否必传 | 名称 | 描述 |
---|---|---|---|---|
domain | list | 否 | 域名 | 域名列表 |
start_time | int | 是 | 开始时间戳 | 开始时间戳,单位秒 |
end_time | int | 是 | 结束时间戳 | 结束时间戳,单位秒 |
httpProtocol | int | 否 | 协议类型 | 协议类型,不传默认全部协议类型。 0(http),1(https) |
返回参数说明
参数 | 类型 | 是否必传 | 名称及描述 |
---|---|---|---|
code | int | 是 | 状态码 |
message | string | 是 | 描述信息 |
result | list | 是 | 每个时间间隔的结果 |
result[*].timestamp | int | 是 | 时间片开始时间戳 |
result[*].pv_count | int | 是 | pv |
示例
请求路径:https://cdnapi-global.ctapi.ctyun.cn/statistics/query-pv-data
示例1:
请求参数:
{
"start_time": "1662413100",
"end_time": "1662413700",
"domain": [
"ctyun.cn",
"ctyun.cn1"
],
"httpProtocol": 1
}
返回结果:
{
"code": 100000,
"message": "success",
"result": [
{
"pv_count": 3020171,
"timestamp": 1662706800
},
{
"pv_count": 2993556,
"timestamp": 1662707100
},
{
"pv_count": 2943798,
"timestamp": 1662707400
},
{
"pv_count": 2879866,
"timestamp": 1662707700
},
{
"pv_count": 2865421,
"timestamp": 1662708000
}
]
}
示例2:
请求参数:
{
"start_time": "1662413100",
"domain": [
"ctyun.cn",
"ctyun.cn1"
]
}
返回结果:
{
"code": 100007,
"message": "无法找到必须的请求参数:end_time"
}
错误码请参考:参数code和message含义