如何查询热门Refer?
DescribeDomainTopReferVisit
描述
获取加速域名某天的热门页面引用次数排名
不指定StartTime时，默认读取过去1天的数据。
- 只支持一个域名，或当前用户下所有域名
- 最多可获取最近90天的数据
请求参数
| 参数 | 类型 | 必要 | 描述 |
| Action | String | 是 | 操作接口名，系统规定参数取值：DescribeDomainTopReferVisit |
| DomainName | String | 否 | 只支持一个域名，若参数为空，默认返回所有加速域名合并后数据 |
| StartTime | String | 否 | 获取数据起始时间点，北京时间。格式为：YYYY-MM-DD不写默认读取过去24小时数据。 |
返回参数
| 名称 | 类型 | 描述 |
| RequestId | String | 请求ID |
| DomainName | String | 加速域名信息 |
| StartTime | String | 查询指定日期 |
| TopReferList | ReferList[] | 全部热门ReferUrllist |
ReferList
| 名称 | 类型 | 描述 |
| ReferDetail | String | 完整的ReferUrl地址 |
| VisitData | String | 访问次数 |
特殊错误码
| 错误代码 | 描述 | Http 状态码 | 语义 |
| Throttling | Request was denied due to request throttling. | 503 | 请求被流量控制限制 |
| IllegalOperation | Illegal domain, operation is not permitted. | 403 | 非法域名, 无法操作 |
| OperationDenied | Your account does not open CDN service yet. | 403 | 未开通CDN服务 |
| OperationDenied | Your CDN service is suspended. | 403 | CDN服务已被停止 |
| InvalidDomain.NotFound | The domain provided does not belong to you. | 404 | 域名不存在或不属于当前用户 |
| InvalidDomain.Offline | The domain provided is offline. | 404 | 域名已下线 |
| ServiceBusy | The specified Domain is configuring, please retry later. | 403 | 域名正在配置中, 请稍后再试 |
| InvalidDomain.Configure_failed | Failed to configure the provided domain. | 500 | 域名配置失败 |
| MissingParameter | The specified value of parameter StartTime is not valid. | 400 | 缺少StartTime参数 |
| InvalidStartTime.Malformed | Specified start time is malformed. | 400 | StartTime格式错误 |
| InvalidStartTime.ValueNotSupported | Specified end time does not math the specified start time. | 400 | 当前时间和StartTime差值超过90天 |
| InvalidDomainName.ValueNotSupported | The specified value of parameter DomainName only support one or empty value. | 400 | DomainName只支持一个值或者不填 |
示例
请求示例：
http://cdn.aliyuncs.com?Action=DescribeDomainTopReferVisit&DomainName=test.com
&StartTime=2015-11-28
&<公共请求参数>
返回示例：
JSON格式
{
"TopReferList": {
"ReferList": [
{
"VisitData": "229567",
"ReferDetail": "-"
},
{
"VisitData": "2496",
"ReferDetail": "123.57.158.8"
},
{
"VisitData": "448",
"ReferDetail": "live-hunantv.cdnpe.com"
},
{
"VisitData": "3",
"ReferDetail": "video.ccdemo.ccgslb.net"
}
]
},
"RequestId": "95994621-8382-464B-8762-C708E73568D1",
"DomainName": "test.com",
"StartTime": "2015-11-28"
}
XML格式：
<DescribeDomainTopReferVisitResponse>
<TopReferList>
<ReferList>
<VisitData>229567</VisitData>
<ReferDetail>-</ReferDetail>
</ReferList>
<ReferList>
<VisitData>2496</VisitData>
<ReferDetail>123.57.158.8</ReferDetail>
</ReferList>
<ReferList>
<VisitData>448</VisitData>
<ReferDetail>live-hunantv.cdnpe.com</ReferDetail>
</ReferList>
<ReferList>
<VisitData>3</VisitData>
<ReferDetail>video.ccdemo.ccgslb.net</ReferDetail>
</ReferList>
</TopReferList>
<RequestId>D2B7CDC9-0B20-42DB-B723-11FCC63120C0</RequestId>
<DomainName>test.com</DomainName>
<StartTime>2015-11-28</StartTime>
</DescribeDomainTopReferVisitResponse>
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
阿里云 AI 助理回答
DescribeDomainTopReferVisit 是阿里云CDN（内容分发网络）服务中的一个API操作，用于获取指定加速域名在某一天内热门页面引用次数的排名信息。这个功能对于分析网站流量来源、监控热门内容以及优化内容分布策略非常有帮助。下面是对该API更详细的说明：
请求参数
- Action: 必填参数，固定值为
DescribeDomainTopReferVisit，表示请求的操作类型。 - DomainName: 可选参数，指定要查询的加速域名。如果未提供，则默认返回当前用户下所有加速域名合并后的数据。
- StartTime: 可选参数，获取数据的起始时间点，格式为
YYYY-MM-DD。如果不指定，默认读取过去24小时的数据。
返回参数
- RequestId: 每次API请求的唯一标识。
- DomainName: 加速域名信息。
- StartTime: 查询指定的日期。
- TopReferList: 包含热门引用URL列表的数组，每个元素是一个
ReferList对象。- ReferDetail: 完整的引用URL地址。
- VisitData: 对应URL的访问次数。
特殊错误码
列举了一些可能遇到的错误代码及其含义，例如请求被限流(Throttling)、非法操作或域名问题等，这些错误码有助于定位和解决调用API时遇到的问题。
示例
请求示例展示了如何通过HTTP GET请求调用此API，URL中包含了必要的Action参数，其他可选参数如需使用，应以查询字符串的形式附加到URL后面。
注意事项
- 只支持查询单个域名或当前用户所有域名的合并数据，且最多获取最近90天的数据。
- 当不指定
StartTime时，系统会自动读取过去1天的数据。 - 确保请求符合频率限制和权限要求，避免因请求过于频繁或账户权限不足导致的错误。
通过理解和正确使用DescribeDomainTopReferVisit API，用户可以有效分析其CDN加速域名下的流量分布情况，进一步优化内容分发策略和提升用户体验。
有帮助
无帮助
AI 助理回答生成答案可能存在不准确，仅供参考
相关问答