接口描述:调用本接口查询多个域名下URL范围量排名,可按流量/请求数排名
请求方式:post
请求路径:/statistics/query-top-url-data
使用说明:
单个用户一分钟限制调用10000次,并发不超过100;
单次查询输入域名的个数不能超过100个;
请求参数说明(json):
参数 | 类型 | 是否必传 | 名称 | 描述 |
---|---|---|---|---|
top_rank | int | 是 | 倒序取top_rank条数据 | 取值区间[1, 100] |
start_time | int | 是 | 开始时间戳 | 起始时间,时间戳(秒) |
end_time | int | 是 | 结束时间戳 | 结束时间,时间戳(秒) |
domain | list<string> | 是 | 域名列表 | 可多个域名,作为统计筛选项 |
http_code | list<string> | 否 | http状态码 | 可多个http状态码,作为统计筛选项,不传默认所有状态码 |
status | string | 否 | 命中状态 | HIT或者MISS,作为统计筛选项,不传默认所有命中状态 |
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 | 否 | |
result[*].request | long | 否 | 请求数 |
result[*].flow | long | 否 | 流量 |
示例:
请求路径:https://cdnapi-global.ctapi.ctyun.cn/statistics/query-top-url-data
示例1:
{ "top_rank": 3, "start_time": 1663948800, "end_time": 1664035200, "domain": [ "ctyun.cn" ] }
返回结果:
{ "code": 100000, "message": "success", "result": [ { "request": 1020625, "port": "80", "channel": "ctyun.cn", "rank": 1, "uri": "/internettv/c1/2022/09/22/03A83443A8CDB5B04BC17F7D561C279D.ts", "flow": 10093939640163 }, { "request": 570929, "port": "80", "channel": "ctyun.cn1", "rank": 2, "uri": "/internettv/c1/2022/09/21/54FDE797FD0FFC3525911EAD768024AA.ts", "flow": 6766921693155 }, { "request": 296100, "port": "80", "channel": "ctyun.cn", "rank": 3, "uri": "/internettv/c1/2022/09/24/317E521155DDFC1E5BA882BE5D7DC019.ts", "flow": 3650153140284 } ] }
示例2:
请求参数:
{ "top_rank": 3, "start_time": 1663948800, "domain": [ "aaa.com" ] }
返回结果:
{ "code": 200002, "message": "无法找到必须的请求参数:end_time" }
错误码请参考:API返回参数code和message含义