GetLiveTopOnlineUserData

描述

本接口用于获取按域名维度统计流的直播在线人数排行

• 只设置起始时间，代表起始时间这1分钟的数据。

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

• 最多可获取最近62天内的数据

• 时效性：5-10分钟延迟

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

• 只支持直播业务

• 使用场景：

  • 客户查询一个单位时间（1分钟）内的TopN的直播流名，然后拿流名去调用“在线人数”的API来绘制单个流的曲线；

• 说明：

  • 按流名维度的数据，返回时并不按照“域名”维度汇聚。如果需要按域名维度的数据，请按单个域名过滤。

请求语法 {#请求语法}

本接口请求需要包含指定目录 /2016-09-01/statistics/GetLiveTopOnlineUserData和公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。

请求参数

返回参数

OnlineUserDataByStream

OnlineUserDataByByRegion

示例

请求示例

POST方式:

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

StartTime=2016-10-20T00:00+0800&ResultType=1&DomainIds=2D09SPW&Regions=CN&LimitN=100

返回示例

JSON格式：

{
  "StartTime": "2016-10-20T00:00+0800",
  "DomainIds": "2D09SPW",
  "Regions": "CN",
  "ResultType": 1,
  "LimitN": 100,
  "Datas": [
    {
      "StreamUrl": "http://test.ks-cdn.com/live/m_2d720db628d9e0321473268364621100.flv",
      "OnlineUser": 12,
      "Regions": [
        {
          "Region": "CN",
          "OnlineUser": 12
        }
      ]
    },
    {
      "StreamUrl": "http://test.ks-cdn.com/live/m_02370dbc72253cb51473083146466100.flv",
      "OnlineUser": 1,
      "Regions": [
        {
          "Region": "CN",
          "OnlineUser": 1
        }
      ]
    },
    {
      "StreamUrl": "http://test.ks-cdn.com/live/m_3d7206bc6085e1621471541327267100.flv",
      "OnlineUser": 1,
      "Regions": [
        {
          "Region": "CN",
          "OnlineUser": 1
        }
      ]
    },
    {
      "StreamUrl": "http://test.ks-cdn.com/live/m_bb8ccf86c5aa995d1471262600384100.flv",
      "OnlineUser": 1,
      "Regions": [
        {
          "Region": "CN",
          "OnlineUser": 1
        }
      ]
    },
    {
      "StreamUrl": "http://test.ks-cdn.com/live/m_bdbde132a294b5c51468166116193100.flv",
      "OnlineUser": 1,
      "Regions": [
        {
          "Region": "CN",
          "OnlineUser": 1
        }
      ]
    },
    {
      "StreamUrl": "http://test.ks-cdn.com/live/m_f72c81748e04ca2e1472148599628100.flv",
      "OnlineUser": 1,
      "Regions": [
        {
          "Region": "CN",
          "OnlineUser": 1
        }
      ]
    }
  ]
}

错误码

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