CDN加速

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

直播在线人数接口

更新时间:2021-11-18 11:11:29

适用产品

直播分发

接口描述

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

请求参数

Params 参数

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

返回参数

参数名称类型描述
countLong在线总人数,仅当查询时间点,即from和to为空时才显示
errorCountLong异常总在线人数,只对有需要客户进行返回
retcodeLong数据条数,仅当查询时间点,即from和to为空时才显示
rettimeString返回的数据的时间
dataValueList数据集合
progString流名, 腾讯的流名经过特殊处理,去掉了域名部分,其他域名的数据显示完整流名
timeString时间,仅当查询时间范围,即channel,from和to参数不为空时才显示
valueLong在线人数
errorValueLong异常在线人数,只对需要客户进行返回

示例

实时
非实时
指定时间点
指定时间范围
拆分域名数据
合并域名数据
请求示例
复制代码 复制成功!
#!/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
    }
  ]
}