获取热门页面引用次数排名_资源监控接口_旧版API参考_CDN

调用该接口前，请您注意：

不指定StartTime，默认读取前1天的数据。
只支持查询一个域名或当前用户下所有域名。
可获取最近90天的数据。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeDomainTopReferVisit	操作接口名，系统规定参数。取值：DescribeDomainTopReferVisit。
DomainName	String	否	www.yourdomain.com	只支持一个域名，如果参数为空，默认返回所有加速域名合并后数据。
StartTime	String	否	2017-12-21	获取数据起始时间点。北京时间，格式为YYYY-MM-DD。不写默认读取过去24小时数据。
SortBy	String	否	pv	排序方式。 traf：流量。 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.	开始时间设置错误，请检查更新后重试。

访问错误中心查看更多错误码。