• 热门
  • 基础
  • 数据库
  • 安全
  • 大数据
  • 人工智能
  • 混合云
  • 开发与运维
  • 企业应用

应用服务

行业引擎

全部文档
当前文档

暂无内容

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

文档中心

直播按域名维度统计在线人数

最近更新时间:2024-04-22 18:16:10

GetLiveOnlineUserDataByDomain

描述

本接口用于获取按域名维度的直播在线人数数据,单位:个

  • 支持按指定的起止时间查询,两者需要同时指定

  • 支持批量域名查询,多个域名ID用逗号(半角)分隔

  • 最多可获取一年内93天跨度的数据

  • 统计粒度:1分钟粒度;5分钟粒度;10分钟粒度;20分钟粒度;1小时粒度;4小时粒度;8小时粒度;1天粒度;以上粒度的在线人数均取该粒度时间段的在线人数的峰值

  • 时效性:3-8分钟延迟

  • 接口性能:接口最大吞吐量为10000,即Region个数*DomainId个数*(EndTime-StartTime) /统计粒度<= 10000。注:在获取多个域名多个区域合并值时,Region个数和DomainId个数按照1计算

  • 只支持直播业务

  • 使用场景:

    • 客户查询单个域名或多域名合并后在线人数数据,用于绘制一条在线人数线图

    • 客户查询单个域名或多个域名的详细在线人数数据,进行数据保存及数据分析

请求语法

本接口请求需要包含指定目录 /2016-09-01/statistics/GetLiveOnlineUserDataByDomain和公共请求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

DomainIds

String

域名ID,缺省为当前产品类型下的全部域名,可输入需要查询的域名ID,支持批量域名查询,多个域名ID用逗号(半角)分隔

Regions

String

区域名称, 取值为CN:中国大陆,AS:亚洲(除中国大陆),NA:北美洲,SA:南美洲,EU:欧洲,AU:大洋洲,非洲:AF,支持多计费区域查询,多个区域用逗号(半角)分隔,缺省为 CN

ResultType

Int

0:多域名多区域数据做合并;1:每个域名每个区域的数据分别返回

Granularity

Int

统计粒度, 1:1分钟粒度;5:5分钟粒度;10:10分钟粒度;20:20分钟粒度;60:1小时粒度;240:4小时粒度;480:8小时粒度;1440:1天粒度;以上粒度均取该粒度时间段的在线人数峰值

返回参数

参数名

类型及范围

说明

StartTime

String

开始时间

EndTime

String

结束时间

CdnType

String

产品类型

DomainIds

String

域名ID列表,逗号(半角)间隔

Regions

String

区域,逗号(半角)间隔

ResultType

Int

取值为0:多域名多区域数据做合并返回;1:每个域名每个区域的数据分别返回

Granularity

Int

统计粒度,取值为 1(默认):1分钟粒度;5:5分钟粒度;10:10分钟粒度;20:20分钟粒度;60:1小时粒度;240:4小时粒度;480:8小时粒度;1440:1天粒度;以上粒度均取该粒度时间段的在线人数峰值

Datas

OnlineUserDataByTime[]

每个时间粒度的在线人数数据

OnlineUserDataByTime

参数名

类型及范围

说明

Time

String

时间点

OnlineUser

Long

在线人数(所选域名合并值)

Domains

OnlineUserDataByDomain[]

每个域名的详细请求数数据(仅当ResultType取值为1时返回此数据)

OnlineUserDataByDomain

参数名

类型及范围

说明

DomainId

String

域名ID

OnlineUser

Long

在线人数(所选域名合并值)

Regions

OnlineUserDataByByRegion[]

该域名在每个区域的详细数据

OnlineUserDataByByRegion

参数

类型

描述

Region

String

区域

OnlineUser

Long

在线人数(所选域名合并值)

示例

请求示例

POST方式:

POST /2016-09-01/statistics/GetLiveOnlineUserDataByDomain 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetLiveOnlineUserDataByDomain
x-version: 2016-09-01
Content-Type: application/x-www-form-urlencoded

StartTime=2016-09-18T09:14+0800&EndTime=2016-09-19T10:20+0800&ResultType=1&Granularity=1440&CdnType=live&DomainIds=&Regions=CN

返回示例

JSON格式

{
  "StartTime": "2016-09-18T09:14+0800",
  "EndTime": "2016-09-19T10:20+0800",
  "DomainIds": "",
  "Regions": "CN",
  "ResultType": "1",
  "Granularity": 1440,
  "Datas": [
    {
      "Time": "2016-09-18 00:00:00",
      "OnlineUser": 1834130,
      "Domains": [
        {
          "DomainId": "2D09SA6",
          "OnlineUser": 1834130,
          "Regions": [
            {
              "Region": "CN",
              "OnlineUser": 1834130
            }
          ]
        }
      ]
    },
    {
      "Time": "2016-09-19 00:00:00",
      "OnlineUser": 406447,
      "Domains": [
        {
          "DomainId": "2D09SA6",
          "OnlineUser": 406447,
          "Regions": [
            {
              "Region": "CN",
              "OnlineUser": 406447
            }
          ]
        }
      ]
    }
  ]
}

错误码

下方为接口业务逻辑相关的错误码,其他错误码详见公共错误码

错误代码(Code)

错误消息(Message)

HTTP 状态码

中文描述(语义)

InvalidStartTime.Malformed

Specified start time is malformed.StartTime:%s

400

StartTime格式错误

NoDataProvided

We do not provide data more than 1 year.

400

所查询的时间范围超过限制

InvalidEndTime.Malformed

Specified end time is malformed.%s

400

EndTime格式错误

InvalidEndTime.Mismatch

Specified end time should not be earlier than start time.StartTime:%s, EndTime:%s

400

EndTime不应早于StartTime

InvalidTime

Start time with the time difference is not more than 1 years.

400

所查询的时间跨度超过限制

InvalidTime

Start time with the time difference is not more than 93 days.

400

不支持查询93天前的数据

InvalidRegion

Invalid region.Expected:AF/AS/AU/CN/EU/NA/SA/HK/TW, but receive:%s

400

无效的区域名称

InvalidResultType

Invalid result type.Expected:0/1, but receive:%s

400

无效的数据类型,应该为0/1

InvalidGranularity

Invalid granularity.Option for granularity is 5, 10, 20, 60, 240, 480, 1440 (min), received:%s

400

无效的统计粒度

NoAvailableDomain

No valid domain name was found according to the query criteria.

400

所查询的域名在当前查询条件下没数据

InvalidDomain.NotFound

The domain provided does not belong to you or does not match the cdntype.Invalid domains:%s

400

直播业务不存在此域名

InvalidDomain.Offline

The domain provided is offline.Offline domains:%s

400

所查询的域名已经停用

DomainCdnTypeNotMatch

Domains and cdn type did not match.Invalid domains:%s

400

域名和域名类型不匹配

AccessDenied

Access Denied.You are not authorized to perform:DomainIds:%s

403

权限不够,访问被拒绝

TooManyDataPoints

Too many data points in this request.%s

400

所查询的数据超过接口最大吞吐量

纯净模式常规模式

纯净模式

点击可全屏预览文档内容

鼠标选中内容,快速反馈问题

如果在文档使用中出现问题,可选中有问题的部分进行快速反馈,我们将跟进处理。
不再提示
好的,我知道了

聆听反馈