查询主播流时长接口

最近更新时间:2020-10-29 19:31:10

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

接口说明

  • 此接口用来统计某App下所有流或单条流的推流时长信息
  • 使用前提:此接口开通后才能使用,请联系技术支持,开通维度:UniqueName
  • 时间范围:60天
  • 查询时间间隔:开始和结束时间不能为同一天
  • 统计方式:以0点为统计的开始和结束点,举例说明:输入的开始时间在前天,结束时间在今天,则返回前天0点到今天0点这条流的推流时长信息

请求参数

参数名 类型 是否必须 描述
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 推流开始时间
EndTime Int 推流结束时间
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"
}

错误码

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

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

免费注册