调用DescribeDcdnDomainTopUrlVisit获取加速域名某天内的热门URL列表,支持获取最近90天的数据。

调用该接口前,请您注意:
  • 不指定StartTime,默认读取前一天的数据。
  • 只支持一个域名。

调试

您可以在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(默认值):访问次数。

返回数据

名称 类型 示例值 描述
AllUrlList Array

全部热门URLlist。

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

返回为2xx的Urllist。

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

返回为3xx的Urllist。

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

返回为4xx的Urllist。

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

返回为5xx的Urllist。

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

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