调用DescribeScdnDomainTopReferVisit获取加速域名某天的热门页面引用次数排名。
说明
- 不指定StartTime时,默认读取过去1天的数据。
- 只支持一个域名。最多可获取最近90天的数据。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeScdnDomainTopReferVisit |
系统规定参数。取值:DescribeScdnDomainTopReferVisit。 |
DomainName | String | 是 | example.com |
加速域名信息,只支持一个域名。 |
StartTime | String | 否 | 2018-10-03T16:00:00Z |
开始获取数据的时间点。不写默认读取过去24小时数据。 格式为:YYYY-MM-DDThh:mm:ssZ。 查询某天的数据,建议传YYYY-MM-DDT16:00:00Z。 |
SortBy | String | 否 | pv |
排序方式,支持traf和pv,默认pv。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
StartTime | String | 2018-10-03T16:00:00Z |
查询指定日期。 |
RequestId | String | 95994621-8382-464B-8762-C708E73568D1 |
请求ID。 |
DomainName | String | example.com |
加速域名信息。 |
TopReferList | Array of ReferList |
热门ReferUrl列表。 |
|
ReferList | |||
Flow | String | 460486880 |
流量。单位:byte。 |
FlowProportion | Float | 0.35 |
流量占比。 |
VisitData | String | 229567 |
访问次数。 |
ReferDetail | String | 123.XXX.XXX.158 |
完整的ReferUrl地址。 |
VisitProportion | Float | 0.35 |
访问占比。 |
示例
请求示例
http(s)://scdn.aliyuncs.com/?Action=DescribeScdnDomainTopReferVisit
&DomainName=example.com
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeScdnDomainTopReferVisitResponse>
<TopReferList>
<ReferList>
<Flow>460486880</Flow>
<VisitProportion>0.35</VisitProportion>
<VisitData>229567</VisitData>
<ReferDetail>-</ReferDetail>
<FlowProportion>0.35</FlowProportion>
</ReferList>
<ReferList>
<Flow>460486880</Flow>
<VisitProportion>0.35</VisitProportion>
<VisitData>2496</VisitData>
<ReferDetail>123.XXX.XXX.158</ReferDetail>
<FlowProportion>0.35</FlowProportion>
</ReferList>
<ReferList>
<Flow>460486880</Flow>
<VisitProportion>0.35</VisitProportion>
<VisitData>448</VisitData>
<ReferDetail>example.aliyundoc.com</ReferDetail>
<FlowProportion>0.35</FlowProportion>
</ReferList>
<ReferList>
<Flow>460486880</Flow>
<VisitProportion>0.35</VisitProportion>
<VisitData>3</VisitData>
<ReferDetail>example.aliyundoc.com</ReferDetail>
<FlowProportion>0.35</FlowProportion>
</ReferList>
</TopReferList>
<RequestId>95994621-8382-464B-8762-C708E73568D1</RequestId>
<DomainName>example.com</DomainName>
<StartTime>2018-10-03T16:00:00Z</StartTime>
</DescribeScdnDomainTopReferVisitResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TopReferList" : {
"ReferList" : [ {
"Flow" : 460486880,
"VisitProportion" : 0.35,
"VisitData" : 229567,
"ReferDetail" : "-",
"FlowProportion" : 0.35
}, {
"Flow" : 460486880,
"VisitProportion" : 0.35,
"VisitData" : 2496,
"ReferDetail" : "123.XXX.XXX.158",
"FlowProportion" : 0.35
}, {
"Flow" : 460486880,
"VisitProportion" : 0.35,
"VisitData" : 448,
"ReferDetail" : "example.aliyundoc.com",
"FlowProportion" : 0.35
}, {
"Flow" : 460486880,
"VisitProportion" : 0.35,
"VisitData" : 3,
"ReferDetail" : "example.aliyundoc.com",
"FlowProportion" : 0.35
} ]
},
"RequestId" : "95994621-8382-464B-8762-C708E73568D1",
"DomainName" : "example.com",
"StartTime" : "2018-10-03T16:00:00Z"
}