调用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

排序方式。取值:

  • traf:流量。
  • 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. 不支持该开始时间,请重新填写。

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