调用DescribeDcdnDomainTopUrlVisit获取加速域名某天内的热门URL列表。
说明 最多可获取近7天的数据。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDcdnDomainTopUrlVisit |
操作接口名,系统规定参数。取值:DescribeDcdnDomainTopUrlVisit。 |
DomainName | String | 是 | example.com |
加速域名,只支持传入一个域名。 |
StartTime | String | 否 | 2018-10-03T16:00:00Z |
开始获取数据的时间点。 日期格式按照ISO8601表示法,并使用UTC时间,格式为:YYYY-MM-DDThh:mm:ssZ。 如果需要查询某天的数据,建议传入:YYYY-MM-DDT16:00:00Z。 说明 不传该参数默认读取过去24小时的数据。
|
SortBy | String | 否 | pv |
排序方式。取值:
默认值为pv。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
AllUrlList | Array of UrlList |
全部热门URL列表。 |
|
UrlList | |||
Flow | String | 460486880 |
流量。单位:byte。 |
FlowProportion | Float | 0.35 |
流量占比。 |
UrlDetail | String | http://example.com/nn_live/nn_x64/a0.m3u8 |
完整的URL地址。 |
VisitData | String | 161673 |
访问次数。 |
VisitProportion | Float | 0.35 |
访问占比。 |
DomainName | String | example.com |
加速域名。 |
RequestId | String | 64D28B53-5902-409B-94F6-FD46680144FE |
请求ID。 |
StartTime | String | 2018-10-03T16:00:00Z |
查询指定日期。 |
Url200List | Array of UrlList |
返回为2xx的URL列表。 |
|
UrlList | |||
Flow | String | 460486880 |
流量。单位:byte。 |
FlowProportion | Float | 0.35 |
流量占比。 |
UrlDetail | String | http://example.com/nn_live/nn_x64/a0.m3u8 |
完整的URL地址。 |
VisitData | String | 161673 |
访问次数。 |
VisitProportion | Float | 0.35 |
访问占比。 |
Url300List | Array of UrlList |
返回为3xx的URL列表。 |
|
UrlList | |||
Flow | String | 460486880 |
流量。单位:byte。 |
FlowProportion | Float | 0.35 |
流量占比。 |
UrlDetail | String | http://example.com/nn_live/nn_x64/a0.m3u8 |
完整的URL地址。 |
VisitData | String | 161673 |
访问次数。 |
VisitProportion | Float | 0.35 |
访问占比。 |
Url400List | Array of UrlList |
返回为4xx的URL列表。 |
|
UrlList | |||
Flow | String | 460486880 |
流量。单位:byte。 |
FlowProportion | Float | 0.35 |
流量占比。 |
UrlDetail | String | http://example.com/nn_live/nn_x64/a0.m3u8 |
完整的URL地址。 |
VisitData | String | 161673 |
访问次数。 |
VisitProportion | Float | 0.35 |
访问占比。 |
Url500List | Array of UrlList |
返回为5xx的URL列表。 |
|
UrlList | |||
Flow | String | 460486880 |
流量。单位:byte。 |
FlowProportion | Float | 0.35 |
流量占比。 |
UrlDetail | String | http://example.com/nn_live/nn_x64/a0.m3u8 |
完整的URL地址。 |
VisitData | String | 161673 |
访问次数。 |
VisitProportion | Float | 0.35 |
访问占比。 |
示例
请求示例
http(s)://dcdn.aliyuncs.com/?Action=DescribeDcdnDomainTopUrlVisit
&DomainName=example.com
&StartTime=2018-10-03T16:00:00Z
&<公共请求参数>
正常返回示例
XML
格式
<DescribeDcdnDomainTopUrlVisitResponse>
<AllUrlList>
<UrlList>
<VisitData>161673</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/a0.m3u8</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
<UrlList>
<VisitData>37</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/ZXg9MQ,,/HNJSMPP360.ts</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
</AllUrlList>
<Url300List>
<UrlList>
<VisitData>161673</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU0GNfbGl2ZQ,,/HNJSMPP360.m3u8</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
<UrlList>
<VisitData>3</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDZXg9MQ,,/HNJSMPP360.ts</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
</Url300List>
<Url400List>
<UrlList>
<VisitData>1884</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUhbGxfcGNfbGl2ZQ,,/HNJSMPP360.m3u8</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
<UrlList>
<VisitData>1</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SEEwODgmpbmRleZPTE,/HNJSMPP360.ts</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
</Url400List>
<RequestId>64D28B53-5902-409B-94F6-FD46680144FE</RequestId>
<DomainName>example.com</DomainName>
<Url200List>
<UrlList>
<VisitData>161673</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU0bGxfcGNfbGl2ZQ,,/HNJSMPP360.m3u8</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
<UrlList>
<VisitData>3</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDMlPTIwMTxMDk5ZXg9MQ,,/HNJSMPP360.ts</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
</Url200List>
<StartTime>2018-10-03T16:00:00Z</StartTime>
<Url500List>
<UrlList>
<VisitData>161673</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU0GNfbGl2ZQ,,/HNJSMPP360.m3u8</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
<UrlList>
<VisitData>3</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDZXg9MQ,,/HNJSMPP360.ts</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
</Url500List>
</DescribeDcdnDomainTopUrlVisitResponse>
JSON
格式
{
"AllUrlList": {
"UrlList": [
{
"VisitData": "161673",
"UrlDetail": "http://example.com/nn_live/nn_x64/a0.m3u8",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "37",
"UrlDetail": "http://example.com/nn_live/nn_x64/ZXg9MQ,,/HNJSMPP360.ts",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
}
]
},
"Url300List": {
"UrlList": [
{
"VisitData": "161673",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU0GNfbGl2ZQ,,/HNJSMPP360.m3u8",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "3",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDZXg9MQ,,/HNJSMPP360.ts",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
}
]
},
"Url400List": {
"UrlList": [
{
"VisitData": "1884",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUhbGxfcGNfbGl2ZQ,,/HNJSMPP360.m3u8",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "1",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SEEwODgmpbmRleZPTE,/HNJSMPP360.ts",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
}
]
},
"RequestId": "64D28B53-5902-409B-94F6-FD46680144FE",
"DomainName": "example.com",
"Url200List": {
"UrlList": [
{
"VisitData": "161673",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU0bGxfcGNfbGl2ZQ,,/HNJSMPP360.m3u8",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "3",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDMlPTIwMTxMDk5ZXg9MQ,,/HNJSMPP360.ts",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
}
]
},
"StartTime": "2018-10-03T16:00:00Z",
"Url500List": {
"UrlList": [
{
"VisitData": "161673",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU0GNfbGl2ZQ,,/HNJSMPP360.m3u8",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "3",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDZXg9MQ,,/HNJSMPP360.ts",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
}
]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidStartTime.Malformed | The specified StartTime parameter is invalid. | 请提供正确的开始时间格式。日期格式按照ISO8601表示法,并使用UTC时间,格式为:yyyy-MM-ddTHH:mm:ssZ。 |
400 | InvalidStartTime.ValueNotSupported | The specified StartTime is invalid. | 不支持该开始时间,请重新填写。 |
访问错误中心查看更多错误码。