全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

查询热门URL

最近更新时间:2022-03-17 17:10:29

GetTopUrlData

描述

本接口用于获取域名某天内某一时段的TOP Url访问数据,仅包含Top200且访问次数大于15次的 Url的访问次数(请求数)、流量,并支持按请求数或流量排序

  • 支持批量域名查询,多个域名ID用逗号(半角)分隔
  • 最多可获取最近一年内24小时跨度的数据
  • 时效性:30分钟延迟
  • 单次查询域名数量不得超过1000个,且单次查询时间跨度至少包含一个时间粒度点(如,粒度为5分钟的时候,单次查询起止时间应大于等于五分钟)
  • 参数过滤说明:查询跨度大于天时,索引数据量太大,严重影响存储和查询性能,按天聚合流量<4096000B的查询结果会被过滤,因此可能导致按小时查询结果条数大于按天查询结果数

请求语法

本接口请求需要包含指定目录/2020-06-30/statistics/GetTopUrlData和公共请求header和该接口所特有的请求参数,具体请求语句参照下文请求示例。

请求参数

参数名 必选 类型及范围 说明
StartTime String 获取数据起始时间点,日期格式按ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800
EndTime String 结束时间需大于起始时间;获取日期格式按照ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800
CdnType String 产品类型,只允许输入一种类型,取值为wcdn:全站加速
Domains String 域名,缺省为当前产品类型下的全部域名,可输入需要查询的域名,支持批量域名查询,多个域名用逗号(半角)分隔
LimitN Int 热门Url条数,取值为1-200,最大200,默认100
SortBy String 排序方式,取值为flow:流量,pv:请求数,缺省为pv

返回参数

参数名 类型及范围 说明
参数名 类型及范围 说明
StartTime String 开始时间
EndTime String 结束时间
CdnType String 产品类型
Domains String 域名
LimitN Int 热门Url条数
SortBy String 排序方式
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
Datas UrlList[] 热门Url列表

UrlList

参数名 类型及范围 说明
Url String URL地址
Rank Long 排名
Pv Long 访问次数
PvProportion Double 服务请求数占比(该URL在所选时间段内的请求数占所有域名请求数总量的百分比)
Flow Long 访问流量
FlowProportion Double 流量占比(该域名在所选时间段内的流量占所有域名流量总量的百分比)

示例

请求示例

GET方式:

GET /2020-06-30/statistics/GetTopUrlData?StartTime=2020-09-01T08%3a00%2b0800&EndTime=2020-09-01T08%3a05%2b0800&CdnType=wcdn&LimitN=10&SortBy=flow
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetTopUrlData
x-version: 2020-06-30

POST方式:

POST /2020-06-30/statistics/GetTopUrlData
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetTopUrlData
x-version: 2020-06-30
Content-Type: application/json
{
    "StartTime":"2020-09-01T08:00+0800",
    "EndTime":"2020-09-01T08:05+0800",
    "CdnType":"wcdn",
    "LimitN":10,
    "SortBy":"flow"
}

返回示例

{
    "StartTime": "2020-09-01T08:00+0800",
    "EndTime": "2020-09-01T08:05+0800",
    "CdnType": "wcdn",
    "Domains": "www.test.com",
    "LimitN": 10,
    "SortBy": "flow",
    "Datas": [
        {
            "Url": "http://www.test.com/test.txt",
            "Rank": 1,
            "Pv": 352,
            "PvProportion": 100.0,
            "Flow": 257285,
            "FlowProportion": 100.0
        }
    ],
    "RequestId": "6b901375-8803-4653-8efb-b62566b7c675"
}

错误码

为了帮您快速定位问题,WCDN将错误码集中归类,请到【使用须知】查看详情。

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈