全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

查询主播流时长

最近更新时间:2024-03-27 15:34:26

查询主播流时长(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"
}
 

错误码

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

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈