查询域名维度在线人数

查询域名维度在线人数（GetLiveOnlineUserDataByDomain）

接口描述

• 用于获取按域名维度的直播在线人数数据，单位：个

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

• 支持批量域名查询，多个域名ID用逗号（半角）分隔

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

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

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

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

• 只支持直播业务（HLS域名也支持）

• 使用场景：

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

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

• 签名机制：

  • Service取值：cdn

• 接入地址：cdn.api.ksyun.com︎

请求参数

返回参数

OnlineUserDataByTime

OnlineUserDataByDomain

OnlineUserDataByApp

OnlineUserDataByByRegion

请求示例

POST /?Action=GetLiveOnlineUserDataByDomain&Version=2020-09-01&StartTime=2016-09-18T09:14+0800&EndTime=2016-09-19T10:20+0800&ResultType=1&Granularity=1440&DomainNames=&Apps=&Regions=CN HTTP/1.1
Content-Type: application/x-www-form-urlencoded
X-Amz-Date: YOURDATE
Authorization: authorization string
Host: cdn.api.ksyun.com

返回示例

{
  "StartTime": "2016-09-18T09:14+0800",
  "EndTime": "2016-09-19T10:20+0800",
  "DomainType":"Pull",
  "DomainNames": "",
  "Apps": "",
  "Regions": "CN",
  "ResultType": "1",
  "Granularity": 1440,
  "Datas": [
    {
      "Time": "2016-09-18 00:00:00",
      "OnlineUser": 1834130,
      "Domains": [
        {
          "DomainName": "abc.com",
          "OnlineUser": 1834130,
          "Apps": [
            {
              "App": "live1",
              "OnlineUser": 1834130,
              "Regions":[
              {
              "Region": "CN",
              "OnlineUser": 1834130
              }]
            }
          ]
        }
      ]
    },
    {
      "Time": "2016-09-18 00:05:00",
      "OnlineUser": 406447,
      "Domains": [
        {
          "DomainName": "abc.com",
          "OnlineUser": 406447,
          "Apps": [
            {
              "App": "live1",
              "OnlineUser": 406447,
              "Regions":[
              {
              "Region": "CN",
              "OnlineUser": 406447
              }
              ]
            }
          ]
        }
      ]
    }
  ]
}

错误码

此接口为CDN接口，请到使用须知查看错误码详情。