CDN加速

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

直播在线人数接口

更新时间:2022-01-24 15:57:37

适用产品

直播分发

接口描述

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

请求参数

Params 参数

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

返回参数

Body 参数

参数名称类型描述
count
Long在线总人数,仅当查询时间点,即from和to为空时才显示
errorCount
Long异常总在线人数,只对有需要客户进行返回
retcode
Long数据条数,仅当查询时间点,即from和to为空时才显示
rettime
String返回的数据的时间
dataValue
List数据集合
prog
String流名, 腾讯的流名经过特殊处理,去掉了域名部分,其他域名的数据显示完整流名
time
String时间,仅当查询时间范围,即channel,from和to参数不为空时才显示
value
Long在线人数
errorValue
Long异常在线人数,只对需要客户进行返回

示例

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