CDN加速

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

查询直播流综合统计数据

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

适用产品:直播加速

接口描述

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

请求参数

JSON
参数名称类型必填描述
ustring域名(支持多个域名,以逗号分隔)
tstring20160527152300,不填时非实时为当前时间-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秒)
channelstring流名(支持多个流名,以逗号分隔)
dstring域名类型,可选值:push、pull,默认push push代表推流域名 pull代表拉流域名
realtimestring是否返回实时数据,可选值:true、false,默认false true代表实时数据 false代表非实时数据
showportstring是否返回端口,可选值:true、false,默认false 只有实时数据realtime=true才会返回该数据
gstring查询间隔,可选值10、60,默认60 当g为10时,查询距离时间t最近的整10秒点数据 当g为60时,查询距离时间t最近的整分钟点数据

返回参数

JSON
参数名称类型描述
rettimestring返回的数据的时间
retcodelong数据条数,无数据返回0
histscountlong总在线人数
bandwidthcountlong总频道带宽
datetimelong数据的时间戳
dataValuearray推流信息数据集合
┗inbandwidthlong主播当前码率(转码流没有码率数据) 单位:bps
┗oribandwidthlong原始码率(转码流没有码率数据) 单位:bps
┗delaylong主播延迟(ms)
┗streamnamestring主播流名
┗timestring主播开始推流时间(实时数据才有该字段)
┗fpslong主播当前编码帧率
┗lfrdouble主播当前丢帧率
┗deployaddressstring推流cdn节点IP
┗inaddressstring主播出口地址
┗histslong在线人数
┗ofrlong主播原始帧率
┗resolutionstring分辨率
┗vcodecstring视频编码
┗acodecstring音频编码
┗portlong主播推流端口(实时数据才有该字段)
┗bandwidthlong频道当前观看带宽 单位:bps(非实时数据才有该字段)

错误码

错误代码(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 //数据的时间戳

}