查询主播流时长接口(ListStreamDurations )

接口说明

• 此接口用来统计某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"
}
 

错误码

为了帮您快速定位问题，云直播将错误码集中归类，请到错误码中心查看详情。