全部文档
当前文档

暂无内容

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

文档中心

查询主播流时长接口

最近更新时间:2020-11-10 15:55:21

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

错误码

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

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

纯净模式

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