接口描述:调用本接口查询多个域名下URL范围量排名,可按流量/请求数排名
请求方式:post
请求路径:/statistics/query-top-url-data
使用说明:
- 单个用户一分钟限制调用10000次,并发不超过100;
- 单次查询输入域名的个数不能超过100个;
请求参数说明:
参数 | 类型 | 是否必传 | 名称 | 描述 |
---|---|---|---|---|
domain | list< string > | 是 | 域名列表 | 可多个域名,作为统计筛选项 |
start_time | int | 是 | 开始时间戳 | 起始时间,时间戳(秒) |
end_time | int | 是 | 结束时间戳 | 结束时间,时间戳(秒) |
top_rank | int | 是 | 倒序取top_rank条数据 | 取值区间[1, 100] |
http_code | list< string > | 否 | http状态码 | 可多个http状态码,作为统计筛选项,支持2XX/3XX/4XX/5XX,不传默认所有状态码 |
status | string | 否 | 命中状态 | HIT或者MISS,作为统计筛选项,不传默认所有命中状态 |
protocol | string | 否 | 是否合并协议 | 是否合并协议,true或者false,默认true |
sort_type | string | 否 | 排序指标 | flow或者request,作为统计筛选项,不传默认flow |
返回参数说明:
参数 | 类型 | 是否必传 | 名称及描述 |
---|---|---|---|
code | int | 是 | 状态码 |
message | string | 是 | 描述信息 |
result | list< object > | 否 | 统计结果 |
result[*].rank | int | 否 | 排名 |
result[*].channel | string | 否 | 域名 |
result[*].uri | string | 否 | uri值 |
result[*].port | string | 否 | url的端口 |
result[*].protocol | string | 否 | 协议,合并协议时不返回 |
result[*].request | long | 否 | 请求数 |
result[*].flow | long | 否 | 流量 |
示例:
请求路径:https://cdnapi-global.ctapi.ctyun.cn/statistics/query-top-url-data
请求参数:
{
"domain": [
"aa.bb.ctyun.cn"
],
"start_time": 1669001453,
"end_time": 1669087853,
"top_rank": 2
}
返回结果:
{
"result": [
{
"request": 30036,
"port": "80",
"channel": "aa.bb.ctyun.cn",
"rank": 1,
"uri": "/123/637c1a5b/video/tos/cn/tt/567/",
"flow": 37873768442
},
{
"request": 102,
"port": "80",
"channel": "aa.bb.ctyun.cncom",
"rank": 2,
"uri": "/123/637c1a5b/video/tos/cn/tt/56799/",
"flow": 27959264073
}
],
"code": 100000,
"message": "success"
}
错误码请参考:参数code和message含义