CDN加速

文档中心 API文档 其他 查询直播流综合统计数据

查询直播流综合统计数据

更新时间:2021-11-18 11:10:13

适用产品

直播分发

接口描述

该API 具体提供包括码率、帧率、在线人数、头部信息四类直播流状态信息 四类信息可单独开通,供选择性查询

请求参数

Params 参数

参数名称类型必填描述
u
String域名(支持多个域名,以逗号分隔)
t
String20160527152300,不填时非实时为当前时间-5分钟,实时为当前时间-30秒 详解: (t不传,获取当前系统时间,对秒取整(如:2017/3/28 14:38:55 对秒取整后2017/3/28 14:38:50),然后如果查询类型为非实时:对取整后的时间-300(5分钟);如果为实时:对取整后的时间-30(30秒分钟);)如果查询间隔g=10,最后获得的时间(dateFrom)对秒取整(如:2017/3/28 14:38:55 对秒取整后2017/3/28 14:38:50);如果g!=10,对分钟取整:(如:2017/3/28 14:38:55 对秒取整后2017/3/28 14:38:00);dateTo=dataFrom+9(9秒)
channel
String流名(支持多个流名,以逗号分隔)
d
String域名类型,可选值:push、pull,默认push push代表推流域名 pull代表拉流域名
realtime
String是否返回实时数据,可选值:true、false,默认false true代表实时数据 false代表非实时数据
showport
String是否返回端口,可选值:true、false,默认false 只有实时数据realtime=true才会返回该数据
g
String查询间隔,可选值10、60,默认60 当g为10时,查询距离时间t最近的整10秒点数据 当g为60时,查询距离时间t最近的整分钟点数据

返回参数

Body 参数

参数名称类型描述
rettime
String返回的数据的时间
retcode
Long数据条数,无数据返回0
histscount
Long总在线人数
bandwidthcount
Long总频道带宽
datetime
Long数据的时间戳
dataValue
List数据集合
streamname
String主播流名
time
String主播开始推流时间(实时数据才有该字段)
deployaddress
String推流cdn节点IP
inaddress
String主播出口地址
port
Long主播推流端口(实时数据才有该字段)
hists
Long在线人数
inbandwidth
Long主播当前码率(转码流没有码率数据) 单位:bps
oribandwidth
Long原始码率(转码流没有码率数据) 单位:bps
bandwidth
Long频道当前观看带宽 单位:bps(非实时数据才有该字段)
delay
Long主播延迟(ms)
fps
Long主播当前编码帧率
lfr
Double主播当前丢帧率
ofr
Long主播原始帧率
resolution
String分辨率
vcodec
String视频编码
acodec
String音频编码

错误码

错误代码(code)描述(message)HTTP状态码语义
403用户和域名没有关联403
403u和channel不能都为空403
403参数t格式不正确403

示例

查询实时数据
查询非实时数据
查询实时数据
请求示例
复制代码 复制成功!
#!/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/api/quality/stream-status-statistic?u=push1.test.com&channel=push1.test.com/test/test1&d=push&g=10&t=20180706080000&realtime=true&showport=true" \
-X GET \
-u "$account:$PASSW" \
-H "Date: $DATE" \
-H 'Accept: application/json'
返回示例
复制代码 复制成功!
{

       "dataValue":

              [{

                     "streamname":"push1.test.com/test/test1", //频道URL,域名/发布点/流名

                     "time":"20151010113500", //推流开始时间

                     "inaddress":"xxx.xxx.xxx.xxx", //主播出口地址

                     "deployaddress ":"xxx.xxx.xxx.xxx", //cdn节点地址

                     "port":8080,//主播推流端口

                     "hists":"20", //在线人数

                     "inbandwidth":1632028, //主播码率

                     "oribandwidth":232028, //原始码率(仅限查询推流域名时返回该字段)

                     "delay":28, //主播延迟

                     "lfr":"21.3", //丢帧率

                     "fps":45, //主播推流节点帧率

                     "ofr":"45", //主播原始帧率

                     "resolution":"320*240", //分辨率

                     "vcodec":"avc", //视频编码

                     "acodec":"aac", //音频编码

              } ] ,

       "retcode":932, //数据条数

       "histscount":"3240", //总在线人数

       "rettime":"2015-10-10 11:36:26", //调用的时间

       "datetime":1439538900 //数据的时间戳

}