CDN加速

文档中心 API文档 其他 直播在线人数接口

直播在线人数接口

更新时间:2021-01-26 09:37:36
适用产品:直播加速

接口描述

提供直播域名或者频道的在线人数接口,接口只支持GET请求方式

请求参数

参数名称类型必填描述
ustring域名(支持多个域名,以逗号分隔)
tint时间,eg:20160527152300,不填时非实时为当前时间-3分钟,实时为当前时间-30秒
dstring域名类型,pull或push,不填时默认为pull
channelstring频道URL(仅支持单频道查询)
fromint开始时间,eg: 20160803103500,from和to都填或都不填,都填时channel参数必填,查询时间跨度最大为两个小时,如果超过两个小时,将查询开始时间两个小时内的数据,可查近1天内在线人数数据
toint结束时间,eg: 20160803103900,from和to都填或都不填,都填时channel参数必填,查询时间跨度最大为两个小时,如果超过两个小时,将查询开始时间两个小时内的数据,可查近20天内在线人数数据
gint查询间隔,可选值10、60s, 当g为10时,查询时间范围内每10秒的在线人数 当g为60时,查询时间范围内整分钟点对应的在线人数
realtimeboolean实时数据控制,默认为false,为true时,数据为实时,为false时,数据为非实时
unpackboolean域名拆分控制,默认为false,为true时,拆分域名数据,为false时,合并域名数据

返回参数

参数名称类型描述
progstring流名, 腾讯的流名经过特殊处理,去掉了域名部分,其他域名的数据显示完整流名
timestring时间,仅当查询时间范围,即channel,from和to参数不为空时才显示
valueint在线人数
errorValueint异常在线人数,只对斗鱼客户进行返回
retcodeint数据条数,仅当查询时间点,即from和to为空时才显示
rettimestring返回的数据的时间
countint在线总人数,仅当查询时间点,即from和to为空时才显示

示例

示例说明
请求示例
复制
#!/bin/bash

account='account'
apikey='passwd'

DATE=`date -R -u | awk '{print $1" "$2" "$3" "$4" "$5" GMT"}'`
PASSW=`echo -en "$DATE" | openssl dgst -sha1 -hmac $apikey -binary | openssl enc -base64`

curl -i --url "http://open.chinanetcenter.com/QOSS/api/onlineViewers?u=pull.test.com&d=pull&realtime=true&t=20180706080000" \
-X GET \
-u "$account:$PASSW" \
-H "Date: $DATE" \
-H 'Accept: application/json'
返回示例
复制
{
  "count": 128820,
  "retcode": 1950,
  "rettime": "2018-07-11 15:49:24",
  "dataValue": [
    {
      "prog": "pull.test.com/live/HfVlq43In2tw",
      "value": 11863
    },
    {
      "prog": "pull.test.com/live/2udv5U3IokLY",
      "value": 11111
    },
    {
      "prog": "pull.test.com/live/OzSgqoFTr6oU",
      "value": 8206
    },
    {
      "prog": "pull.test.com/live/hfaHyWV3rp8m",
      "value": 6536
    }
  ]
}