調用DescribeDomainTopUrlVisit擷取加速網域名稱某個指定時間段內的熱門URL列表（TOP100）。

说明
  • 如果您不指定StartTime和EndTime，該介面預設讀取過去24小時的資料；指定StartTime和EndTime時，按指定的起止時間查詢。
  • 支援擷取最近90天的資料。
  • 該介面只支援查詢一個網域名稱或當前賬戶下所有網域名稱。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String 是 DescribeDomainTopUrlVisit

操作介面名，系統規定參數。取值： DescribeDomainTopUrlVisit 。

DomainName String 是 example.com

待查詢的網域名稱。
StartTime String 否 2019-10-04T00:00:00Z

開始擷取資料的時間點。日期格式按照ISO8601標記法，並使用UTC時間，格式為yyyy-MM-ddTHH:mm:ssZ。

查詢某天的資料，建議傳參格式為yyyy-MM-ddT16:00:00Z。
EndTime String 否 2019-10-04T16:00:00Z

擷取資料結束時間點。日期格式按照ISO8601標記法，並使用UTC時間，格式為yyyy-MM-ddTHH:mm:ssZ。

说明 結束時間需大於開始時間，並且結束時間和開始時間相差不超過7天。
SortBy String 否 pv

排序方式，預設值為 pv 。取值：

  • traf ：流量。
  • 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 2019-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/aWQ9SE5KU0bGxfcGNfbGl2ZQ,,/HNJSMPP360.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/aWQ9SE5KU01QUhbGxfcGNfbGl2ZQ,,/HNJSMPP360.m3u8

完整的URL地址。
VisitData String 1884

次數。
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/aWQ9SE5KU0GNfbGl2ZQ,,/HNJSMPP360.m3u8

完整的URL地址。
VisitData String 161673

次數。
VisitProportion Float 0.35

訪問佔比。

樣本

請求樣本


    http://cdn.aliyuncs.com?Action=DescribeDomainTopUrlVisit &DomainName=example.com &StartTime=2019-10-04T00:00:00Z &EndTime=2019-10-04T16:00:00Z &<公用請求參數>

正常返回樣本

XML 格式 


    <DescribeDomainTopUrlVisitResponse> <Url300List> </Url300List> <AllUrlList> <UrlList> <Flow>9304</Flow> <VisitProportion>0</VisitProportion> <VisitData>2</VisitData> <UrlDetail>http://example.com/nn_live/nn_x64/a0.m3u8</UrlDetail> <FlowProportion>0</FlowProportion> </UrlList> <UrlList> <Flow>3986</Flow> <VisitProportion>0</VisitProportion> <VisitData>1</VisitData> <UrlDetail>http://example.com/nn_live/nn_x64/a0.m3u8</UrlDetail> <FlowProportion>0</FlowProportion> </UrlList> <UrlList> <Flow>784</Flow> <VisitProportion>0</VisitProportion> <VisitData>1</VisitData> <UrlDetail>http://example.com/nn_live/nn_x64/a0.m3u8</UrlDetail> <FlowProportion>0</FlowProportion> </UrlList> </AllUrlList> <Url400List> <UrlList> <Flow>3986</Flow> <VisitProportion>0</VisitProportion> <VisitData>1</VisitData> <UrlDetail>http://example.com/nn_live/nn_x64/a0.m3u8</UrlDetail> <FlowProportion>0</FlowProportion> </UrlList> <UrlList> <Flow>784</Flow> <VisitProportion>0</VisitProportion> <VisitData>1</VisitData> <UrlDetail>http://example.com/nn_live/nn_x64/a0.m3u8</UrlDetail> <FlowProportion>0</FlowProportion> </UrlList> </Url400List> <RequestId>8E7A2ABF-1BB0-4E46-AE3E-58DB3151080C</RequestId> <DomainName>example.com</DomainName> <Url200List> <UrlList> <Flow>9304</Flow> <VisitProportion>0</VisitProportion> <VisitData>2</VisitData> <UrlDetail>http://example.com/nn_live/nn_x64/a0.m3u8</UrlDetail> <FlowProportion>0</FlowProportion> </UrlList> </Url200List> <StartTime>2019-10-04T00:00:00Z</StartTime> <Url500List> </Url500List> </DescribeDomainTopUrlVisitResponse>

JSON 格式 


    { "Url300List": { "UrlList": [] }, "AllUrlList": { "UrlList": [ { "Flow": 9304, "VisitProportion": 0, "VisitData": 2, "UrlDetail": "http://example.com/nn_live/nn_x64/a0.m3u8", "FlowProportion": 0 }, { "Flow": 3986, "VisitProportion": 0, "VisitData": 1, "UrlDetail": "http://example.com/nn_live/nn_x64/a0.m3u8", "FlowProportion": 0 }, { "Flow": 784, "VisitProportion": 0, "VisitData": 1, "UrlDetail": "http://example.com/nn_live/nn_x64/a0.m3u8", "FlowProportion": 0 } ] }, "Url400List": { "UrlList": [ { "Flow": 3986, "VisitProportion": 0, "VisitData": 1, "UrlDetail": "http://example.com/nn_live/nn_x64/a0.m3u8", "FlowProportion": 0 }, { "Flow": 784, "VisitProportion": 0, "VisitData": 1, "UrlDetail": "http://example.com/nn_live/nn_x64/a0.m3u8", "FlowProportion": 0 } ] }, "RequestId": "8E7A2ABF-1BB0-4E46-AE3E-58DB3151080C", "DomainName": "example.com", "Url200List": { "UrlList": [ { "Flow": 9304, "VisitProportion": 0, "VisitData": 2, "UrlDetail": "http://example.com/nn_live/nn_x64/a0.m3u8", "FlowProportion": 0 } ] }, "StartTime": "2019-10-04T00:00:00Z", "Url500List": { "UrlList": [] } }

錯誤碼

HttpCode 錯誤碼 錯誤資訊 描述
400 InvalidStartTime.Malformed Specified StartTime is malformed. 起始時間格式錯誤。日期格式請參考所調用API的協助文檔說明。
400 InvalidEndTime.Malformed Specified EndTime is malformed. 結束時間格式錯誤。日期格式請參考所調用API的協助文檔說明。
400 InvalidStartTime.ValueNotSupported The specified value of parameter StartTime is not supported. 開始時間設定錯誤，請檢查更新後重試。

訪問 錯誤中心查看更多錯誤碼。