最近更新时间:2024-03-27 15:34:26
用来查询域名下某应用或某条流的推流信息
限制访问频率:50次/分钟
调用方式:HTTP GET
数据粒度:100s
签名机制:
Service取值:kls
接入地址:kls.api.ksyun.com︎
参数名 | 类型 | 是否必须 | 描述 |
---|---|---|---|
Action | String | Y | 操作接口名,取值:RealtimePubStreamsInfo |
Version | String | Y | 版本号,取值:2017-01-01 |
UniqueName | String | Y | 域名空间 |
App | String | Y | 应用名 |
Pubdomain | String | Y | 推流域名 |
Stream | String | N | 流名 |
OrderTime | Int | N | 排序类型,0:按推流开始时间降序排列,1:按推流开始时间升序排列 |
Marker | Int | N | 起始游标,默认为0。 0代表第1页的数据,以此类推 |
Limit | Int | N | 每页返回的记录数,默认1000。单页最多返回5000条数据 |
参数名 | 类型 | 描述 |
---|---|---|
UniqueName | String | 域名空间 |
App | String | 应用名 |
Pubdomain | String | 推流域名 |
Stream | String | 流名 |
Count | Int | 本页返回的记录数 |
Marker | Int | 起始游标,默认为0。 0代表第1页的数据,以此类推 |
OrderTime | Int | 排序类型,0:按推流开始时间降序排列,1:按推流开始时间升序排列 |
Total | Int | 符合查询条件的总记录数 |
ClientIP | String | 推流客户端IP |
Width | String | 视频宽度 |
Height | String | 视频高度 |
FrameRate | String | 视频理论帧率 |
Curfps | Int | 视频实时帧率 |
Curbitrate | Int | 视频码率/B |
BwInAudio | String | 音频码率/B |
SampleRate | String | 音频采样率/Hz |
BwReal | String | 总真实码率/B |
BwIn | String | 总理论码率/B |
UpdateTime | Int | 流信息采集UTC时间 |
PubTime | Int | 开始推流的UTC时间 |
RetCode | Int | 响应码 0成功 其他失败 |
RetMsg | String | 响应信息描述 |
GET /?Action=RealtimePubStreamsInfo&Version=2017-01-01&UniqueName=xxx&App=live&Pubdomain=xxx.xxx.com&Marker=0&Limit=2&OrderTime=0 HTTP/1.1
Content-Type: application/json
X-Amz-Date: YOURDATE
Authorization: AWS4-HMAC-SHA256 Credential=YOURAK/YYYYMMDD/cn-beijing-6/kls/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=SIG
Host: kls.api.ksyun.com
{
"Data": {
"App": "live",
"Count": 1,
"Marker": 0,
"OrderTime": 0,
"Pubdomain": "xxx.xxx.com",
"Result": [
{
"BwIn": "52666",
"BwInAudio": "20814",
"BwReal": "52227",
"Clientip": "114.255.44.132",
"Curbitrate": 52666,
"Curfps": 31,
"FrameRate": "30",
"Height": "614",
"Pubtime": 1491033051,
"SampleRate": "44100",
"Stream": "yh668",
"UpdateTime": 1491036296,
"Width": "1092"
}
],
"RetCode": 0,
"RetMsg": "success",
"Total": 1,
"UniqueName": "xxx"
}
}
为了帮您快速定位问题,云直播将错误码集中归类,请到错误码中心查看详情。
纯净模式