全部文档
当前文档
最近更新时间：2024-03-27 15:34:26
此接口用来统计某App下所有流或单条流的推流时长信息
使用前提：此接口开通后才能使用，请联系技术支持，开通维度：UniqueName
时间范围：60天
查询时间间隔：开始和结束时间不能为同一天
统计方式：以0点为统计的开始和结束点，举例说明：输入的开始时间在前天，结束时间在今天，则返回前天0点到今天0点这条流的推流时长信息
限制访问频率：50次/分钟
调用方式：HTTP GET
参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
Action | String | Y | 操作接口名，取值：ListStreamDurations |
Version | String | Y | 版本号，取值：2017-01-01 |
UniqueName | String | Y | 域名空间 |
App | String | Y | 频道 |
Pubdomain | String | Y | 推流域名 |
Stream | String | N | 流名，如果携带则返回单条流的推流时长；否则返回整个App下所有流的推流时长 |
StartUnixTime | Int | Y | 查询开始时间，UTC时间戳，以当天00:00点为开始时间 |
EndUnixTime | Int | Y | 查询结束时间，UTC时间戳，以当天00:00点为结束时间 |
参数名 | 类型 | 描述 |
|---|---|---|
UniqueName | Sring | 域名空间 |
App | Sring | 频道 |
Pubdomain | Sring | 推流域名 |
Stream | Sring | 流名 |
StartTime | Int | 推流开始时间，UTC时间戳 |
EndTime | Int | 推流结束时间，UTC时间戳 |
Duration | Int | 每段推流的总时长 |
Count | Int | 单次返回记录数 |
GET /?Action=ListStreamDurations&Version=2017-01-01&UniqueName=xxx&App=xxx&Pubdomain=xxx&Stream=xxx&StartUnixTime=xxx&EndUnixTime=xxx&公共参数 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请求参数不携带 Stream 时，返回 Pubdomain 下所有流的推流时长
注意：如果同一条流存在断流情况，那么返回多条记录，如下:
{
"Data":{
"App":"live",
"Count":5,
"Pubdomain":"xxx.xxxxx.com",
"Result":[
{
"Duration":11,
"EndTime":1490069354,
"StartTime":1490069283,
"Stream":"10817737"
},
{
"Duration":11,
"EndTime":1490069430,
"StartTime":1490069371,
"Stream":"10817737"
},
{
"Duration":22,
"EndTime":1490069534,
"StartTime":1490069468,
"Stream":"10817737"
},
{
"Duration":33,
"EndTime":1490069816,
"StartTime":1490069777,
"Stream":"10817737"
},
{
"Duration":555,
"EndTime":1490078283,
"StartTime":1490078218,
"Stream":"10817737"
}
],
"RetCode":0,
"RetMsg":"success",
"UniqueName":"xxx"
},
"RequestId":"2125d244-7f40-45f0-91e8-05e046b3a61c"
}请求参数携带 Stream 时，只返回单条流的推流时长，如下
{
"Data":{
"App":"live",
"Count":2,
"Pubdomain":"xxx.xxxxx.com",
"Result":[
{
"Duration":11,
"EndTime":1490072527,
"StartTime":1490072515,
"Stream":"10817737"
},
{
"Duration":11,
"EndTime":1490078283,
"StartTime":1490078218,
"Stream":"10817737"
}
],
"RetCode":0,
"RetMsg":"success",
"UniqueName":"xxx"
},
"RequestId":"2125d244-7f40-45f0-91e8-05e046b3a61c"
}
为了帮您快速定位问题，云直播将错误码集中归类，请到错误码中心查看详情。
纯净模式