调用DescribeDomainTopReferVisit获取加速域名某天的热门页面引用次数排名。
- 不指定StartTime,默认读取前1天的数据。
- 只支持查询一个域名或当前用户下所有域名。
- 可获取最近90天的数据。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDomainTopReferVisit |
操作接口名,系统规定参数。取值:DescribeDomainTopReferVisit。 |
DomainName | String | 否 | www.yourdomain.com |
只支持一个域名,如果参数为空,默认返回所有加速域名合并后数据。 |
StartTime | String | 否 | 2017-12-21 |
获取数据起始时间点。
|
SortBy | String | 否 | pv |
排序方式。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 95994621-8382-464B-8762-C708E73568D1 |
请求ID。 |
DomainName | String | test.com |
加速域名信息。 |
StartTime | String | 2018-10-03 |
查询指定日期。 |
TopReferList | Array |
全部热门URL列表。 |
|
ReferList | |||
ReferDetail | String | live-hunantv.cdnpe.com |
完整的热门页面地址。 |
VisitData | String | 3 |
访问次数。 |
Flow | String | 200 |
流量。单位:byte。 |
FlowProportion | Float | 0.5 |
流量占比。 |
VisitProportion | Float | 0.5 |
访问占比。 |
示例
请求示例
http://cdn.aliyuncs.com/?Action=DescribeDomainTopReferVisit
&DomainName=example.com
&StartTime=2017-12-21
&<公共请求参数>
正常返回示例
XML
格式
<DescribeDomainTopReferVisitResponse>
<TopReferList>
<ReferList>
<VisitData>229567</VisitData>
<ReferDetail>-</ReferDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</ReferList>
<ReferList>
<VisitData>2496</VisitData>
<ReferDetail>123.57.158.8</ReferDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</ReferList>
<ReferList>
<VisitData>448</VisitData>
<ReferDetail>example1.com</ReferDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</ReferList>
<ReferList>
<VisitData>3</VisitData>
<ReferDetail>example2.net</ReferDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</ReferList>
</TopReferList>
<RequestId>95994621-8382-464B-8762-C708E73568D1</RequestId>
<DomainName>example.com</DomainName>
<StartTime>2018-10-03</StartTime>
</DescribeDomainTopReferVisitResponse>
JSON
格式
{
"TopReferList": {
[ {
"VisitData": "229567",
"ReferDetail": "-",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "2496",
"ReferDetail": "123.57.158.8",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "448",
"ReferDetail": "example1.com",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "3",
"ReferDetail": "example2.net",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
}
]
},
"RequestId": "95994621-8382-464B-8762-C708E73568D1",
"DomainName": "example.com",
"StartTime": "2018-10-03"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingParameter | The specified value of parameter "StartTime" is not valid. | 参数“StartTime”的值无效。 |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | 起始时间格式错误。日期格式请参考所调用API的帮助文档说明。 |
400 | InvalidDomainName.ValueNotSupported | The specified value of parameter DomainName only support one or empty value. | 参数DomainName可以为空或最多1个域名。 |
400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 开始时间设置错误,请检查更新后重试。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交