GetUvData

描述

本接口用于获取域名独立请求的IP个数，单位：个

• 支持按指定的起止时间查询，两者需要同时指定
• 支持批量域名查询，多个域名ID用逗号（半角）分隔
• 最多可获取最近一年内31天跨度的数据
• 统计粒度：5分钟粒度
• 时效性：30分钟延迟

请求语法

本接口请求需要包含指定目录/2020-06-30/statistics/GetUvData和公共请求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	域名，缺省为当前产品类型下的全部域名，可输入需要查询的域名，支持批量域名查询，多个域名用逗号（半角）分隔
ResultType	否	String	统计结果数据展示方式，支持不展开（unexpand）和按照域名维度展开（expand），缺省为 不展开

返回参数

参数名	类型及范围	说明
StartTime	String	开始时间
EndTime	String	结束时间
CdnType	String	产品类型
Domains	String	域名列表，逗号（半角）间隔
ResultType	Long	统计结果数据展示方式
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
Datas	UvDataByTime[]	每个时间粒度的独立请求的IP数据

UvDataByTime

参数	类型	描述
Time	String	时间点
Uv	Long	独立请求的IP个数，（所选域名合并值）
Domains	UvDataByDomain[]	每个域名的详细独立请求的IP个数数据ResultType取值为expand时返回此项数据))

UvDataByDomain

参数	类型	描述
Domain	String	域名
Uv	Long	该域名的独立请求的IP个数

示例

请求示例

GET方式：

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

POST方式：

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

返回示例

{
    "StartTime": "2020-09-01T08:00+0800",
    "EndTime": "2020-09-01T08:05+0800",
    "CdnType": "wcdn",
    "Domains": "www.test.com",
    "ResultType": "unexpand",
    "RequestId": "19676df1-e11d-46bf-bc6c-a1f1f2aee7ac",
    "Datas": [
        {
            "Time": "2020-09-01 08:00:00",
            "Uv": 35
        }
    ]
}

错误码

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