查询主播流时长接口

最近更新时间:2020-05-27 21:05:51

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

描述

统计每天主播推流时长;

历史记录:2 个月内;

统计方式:以0点为统计的开始和结束点,如输入的开始时间在前天,结束时间在今天,就返回前天0点到今天0点这条流的推流时长;如果这段时间内流有断流的情况,则返回多条记录;

查询时间间隔:开始和结束时间不能为同一天;

此接口需开通才能应用,请联系技术支持。

描述

请求参数

参数名 类型 是否必须 描述
Action Sring Y 操作接口名,取值:ListStreamDurations
Version String Y 版本号,取值:2017-01-01
UniqueName String Y 域名标识
App String Y 频道
Pubdomain String Y 推流域名
Stream String N 流名,若携带则返回此路流的推流时长,不携带返回整个Pubdomain下所有流的推流时长
StartUnixTime unsignedint Y 查询开始时间,UTC时间戳,以当天00:00点为开始时间
EndUnixTime unsignedint Y 查询结束时间,UTC时间戳,以当天00:00点为结束时间

返回参数

参数名 类型 描述
UniqueName Sring 域名标识
App Sring 频道
Pubdomain Sring 推流域名
Stream Sring 流名
StartTime unsignedint 推流开始时间
EndTime unsignedint 推流结束时间
Duration unsignedint 每段推流的总时长
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 下所有流的推流时长;注意:同一条流若在一天内存在断流情况,则返回多条记录,如下 11;

{
    "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"
}

金山云,开启您的云计算之旅

免费注册