音视频直播LSS

    统计接口

    查询统计数据

    接口描述

    查询特定Domain的统计数据。

    请求语法

    GET /v<version>/statistics/domain/<playDomain>?startDate=<startDate>&endDate=<endDate>&aggregate={true | false} HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: <bce-authorization-string>

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 描述 是否必须
    playDomain String 直播域名
    startDate String 起始时间
    endDate String 结束时间
    aggregate boolean 指定是否聚合,即数据聚合统计或按日统计。有效值:true、false,默认值: false。为true时聚合统计;否则按日统计

    请求示例

    GET /v5/statistics/domain/play.e-web.com.cn?startDate=20160202&endDate=20160205 HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    domain String 直播域名
    startDate String 起始日期
    endDate Number 结束日期
    aggregate Object 聚合统计数据,仅当aggregate=true时存在
    +durationInMinute Number 直播总时长
    +durationInMinute Number 直播总时长
    +peakPlayCount Number 当天峰值播放人数
    +peakBandwidthInBps Number 峰值带宽
    +downstreamInByte Number 总下行流量
    +playCount Number 累计播放请求数,等于用户累计播放时长,单位:分钟
    statistics Object 按日统计数据
    +date String 数据日期
    +durationInMinute Number 直播总时长
    +peakPlayCount Number 当天峰值播放人数
    +peakBandwidthInBps Number 峰值带宽
    +downstreamInByte Number 总下行流量
    +playCount Number 累计播放请求数,等于用户累计播放时长,单位:分钟

    响应示例

    • aggregate值为true

        HTTP/1.1 200 OK
        x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
        Date: Fri, 03 Jul 2015 09:28:13 GMT
        Transfer-Encoding: chunked
        Content-Type: application/json;charset=UTF-8
        Cache-Control: no-cache
        {
            "domain": "play.e-web.com.cn",
            "startDate": 20160101,
            "endDate": 20160201,
            "aggregate": {
                "durationInMinute": 200,
                "peakPlayCount": 100,
                "peakBandwidthInBps": 100,
                "downstreamInByte": 10000,
                "playCount": 200
            }
        }
    • aggregate值为false

        HTTP/1.1 200 OK
        x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
        Date: Fri, 03 Jul 2015 09:28:13 GMT
        Transfer-Encoding: chunked
        Content-Type: application/json;charset=UTF-8
        Cache-Control: no-cache
        {
            "domain": "play.e-web.com.cn",
            "startDate": 20160101,
            "endDate": 20160201,
            "statistics":[
                {
                    "date": "20160202",
                    "durationInMinute": 100,
                    "peakPlayCount": 100,
                    "peakBandwidthInBps": 100,
                    "downstreamInByte": 10000,
                    "playCount": 100
                },{
                    "date": "20160203",
                    "durationInMinute": 100,
                    "peakPlayCount": 100,
                    "peakBandwidthInBps": 100,
                    "downstreamInByte": 10000,
                    "playCount": 50
                }...
            ]
        }

    查询统计概要

    接口描述

    查询当前用户所有Domain的统计概要。

    请求语法

    GET /v<version>/statistics/domain/summary?startTime=<startTime>&endTime=<endTime> HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: <bce-authorization-string>

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 描述 是否必须
    startTime String 起始时间
    endTime String 结束时间

    请求示例

    GET /v5/statistics/domain/summary/?startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-18T00%3a00%3a00Z HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    startTime String 统计数据起始时间
    endTime String 统计数据截止时间
    summary Object 统计概要
    +downStreamInByte Number 累计总流量
    +durationInMinute Number 累计直播时长
    +playCount Number 累计播放时长
    +transcoding Number 累计转码时长(分钟)

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "startTime": "2016-01-01T00:00:00Z",
        "endTime": "2016-01-01T10:00:00Z",
        "summary": {
            "downStreamInByte": 12300000,
            "durationInMinute":1234,
            "playCount": 200
        }
    }

    查询总请求数

    接口描述

    查询当前用户所有Domain的总请求数。

    请求语法

    GET /v<version>/statistics/domain/playcount?startTime=<startTime>&endTime=<endTime>&timeInterval={LONG_TERM | MID_TERM | SHORT_TERM}  HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: <bce-authorization-string>

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 描述 是否必须
    startTime String 起始时间
    endTime String 结束时间
    timeInterval enum 时间间隔,有效值:LONG_TERM(每天)、MID_TERM(每小时)、SHORT_TERM(每5分钟)

    请求示例

    GET /v5/statistics/domain/playcount?startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-19T00%3a00%3a00Z&timeInterval=LONG_TERM HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    domain String 直播域名
    startTime String 统计数据起始时间
    endTime String 统计数据截止时间
    timeInterval enum LONG_TERM, SHORT_TERM, MID_TERM
    hlsStatistics Object hls请求数数组
    +timestamp String 数据时间点
    +playCount Number 播放请求数
    \flvStatistics Object flv请求数数组
    +timestamp String 数据时间点
    +playCount Number 播放请求数
    rtmpStatistics Object rtmp请求数数组
    +timestamp String 数据时间点
    +playCount Number 播放请求数
    totalStatistics Object 总请求数数组
    +timestamp String 数据时间点
    +playCount Number 播放请求数

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "startTime": "2016-01-01T00:00:00Z",
        "endTime": "2016-01-04T00:00:00Z",
        "timeInterval": "LONG_TERM",
        "hlsStatistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "playCount": 50
            },{
                "timestamp": "2016-01-02T00:00:00Z",
                "playCount": 0
            },{
                "timestamp": "2016-01-03T00:00:00Z",
                "playCount": 20
            }
        ],
        "flvStatistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "playCount": 40
            },{
                "timestamp": "2016-01-02T00:00:00Z",
                "playCount": 0
            },{
                "timestamp": "2016-01-03T00:00:00Z",
                "playCount": 10
            }
        ],
        "rtmpStatistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "playCount": 30
            },{
                "timestamp": "2016-01-02T00:00:00Z",
                "playCount": 0
            },{
                "timestamp": "2016-01-03T00:00:00Z",
                "playCount": 40
            }
        ],
        "totalStatistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "playCount": 120
            },{
                "timestamp": "2016-01-02T00:00:00Z",
                "playCount": 0
            },{
                "timestamp": "2016-01-03T00:00:00Z",
                "playCount": 70
            }
        ]
    }

    查询请求数

    接口描述

    查询特定Domain的请求数。

    请求语法

    GET /v<version>/statistics/domain/<playDomain>/playcount?startTime=<startTime>&endTime=<endTime>&timeInterval={LONG_TERM | MID_TERM | SHORT_TERM}  HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: <bce-authorization-string>

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 描述 是否必须
    playDomain String 直播域名
    startTime String 起始时间
    endTime String 结束时间
    timeInterval enum 时间间隔,有效值:LONG_TERM(每天)、MID_TERM(每小时)、SHORT_TERM(每5分钟)

    请求示例

    GET /v5/statistics/domain/demo.domain.com/playcount?startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-19T00%3a00%3a00Z&timeInterval=LONG_TERM HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    domain String 直播域名
    startTime String 统计数据起始时间
    endTime String 统计数据截止时间
    timeInterval enum LONG_TERM, SHORT_TERM, MID_TERM
    hlsStatistics Object hls请求数数组
    +timestamp String 数据时间点
    +playCount Number 播放请求数
    flvStatistics Object flv请求数数组
    +timestamp String 数据时间点
    +playCount Number 播放请求数
    rtmpStatistics Object rtmp请求数数组
    +timestamp String 数据时间点
    +playCount Number 播放请求数
    totalStatistics Object 总请求数数组
    +timestamp String 数据时间点
    +playCount Number 播放请求数

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "domain": "play.e-web.com.cn",
        "startTime": "2016-01-01T00:00:00Z",
        "endTime": "2016-01-04T00:00:00Z",
        "timeInterval": "LONG_TERM",
        "hlsStatistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "playCount": 50
            },{
                "timestamp": "2016-01-02T00:00:00Z",
                "playCount": 0
            },{
                "timestamp": "2016-01-03T00:00:00Z",
                "playCount": 20
            }
        ],
        "flvStatistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "playCount": 40
            },{
                "timestamp": "2016-01-02T00:00:00Z",
                "playCount": 0
            },{
                "timestamp": "2016-01-03T00:00:00Z",
                "playCount": 10
            }
        ],
        "rtmpStatistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "playCount": 30
            },{
                "timestamp": "2016-01-02T00:00:00Z",
                "playCount": 0
            },{
                "timestamp": "2016-01-03T00:00:00Z",
                "playCount": 40
            }
        ],
        "totalStatistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "playCount": 120
            },{
                "timestamp": "2016-01-02T00:00:00Z",
                "playCount": 0
            },{
                "timestamp": "2016-01-03T00:00:00Z",
                "playCount": 70
            }
        ]
    }

    查询总带宽

    接口描述

    查询当前用户所有Domain的总带宽。

    请求语法

    GET /v<version>/statistics/domain/bandwidth?startTime=<startTime>&endTime=<endTime>&timeInterval={LONG_TERM | MID_TERM | SHORT_TERM}  HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: <bce-authorization-string>

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 描述 是否必须
    startTime String 起始时间
    endTime String 结束时间
    timeInterval enum 时间间隔,有效值:LONG_TERM(每天)、MID_TERM(每小时)、SHORT_TERM(每5分钟)

    请求示例

    GET /v5/statistics/domain/bandwidth?startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-19T00%3a00%3a00Z&timeInterval=LONG_TERM HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    startTime String 统计数据起始时间
    endTime String 统计数据截止时间
    timeInterval String 时间间隔粒度
    statistics Object 统计数据数组
    +timestamp String 数据时间点
    +bandwidthInBps Number 平均带宽,单位:bps (bit per second)

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "startTime": "2016-01-01T00:00:00Z",
        "endTime": "2016-01-01T10:00:00Z",
        "timeInterval" : "SHORT_TERM",
        "statistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "bandwidthInBps": 100
            },{
                "timestamp": "2016-01-01T00:05:00Z",
                "bandwidthInBps": 0
            },{
                "timestamp": "2016-01-01T00:10:00Z",
                "bandwidthInBps": 150
            }
        ]
    }

    查询带宽

    接口描述

    查询特定Domain的带宽。

    请求语法

    GET /v<version>/statistics/domain/<playDomain>/bandwidth?startTime=<startTime>&endTime=<endTime>&timeInterval={LONG_TERM | MID_TERM | SHORT_TERM}  HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: <bce-authorization-string>

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 描述 是否必须
    playDomain String 直播域名
    startTime String 起始时间
    endTime String 结束时间
    timeInterval enum 时间间隔,有效值:LONG_TERM(每天)、MID_TERM(每小时)、SHORT_TERM(每5分钟)

    请求示例

    host:  llss.bj.baidubce.comss.bj.baidubce.com
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    startTime String 统计数据起始时间
    endTime String 统计数据截止时间
    timeInterval String 时间间隔粒度
    statistics Object 统计数据数组
    +timestamp String 数据时间点
    +bandwidthInBps Number 平均带宽,单位:bps (bit per second)

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "startTime": "2016-01-01T00:00:00Z",
        "endTime": "2016-01-01T10:00:00Z",
        "timeInterval" : "SHORT_TERM",
        "statistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "bandwidthInBps": 100
            },{
                "timestamp": "2016-01-01T00:05:00Z",
                "bandwidthInBps": 0
            },{
                "timestamp": "2016-01-01T00:10:00Z",
                "bandwidthInBps": 150
            }
        ]
    }

    查询总流量

    接口描述

    查询当前用户所有Domain的总流量。

    请求语法

    GET /v<version>/statistics/domain/traffic?startTime=<startTime>&endTime=<endTime>&timeInterval={LONG_TERM | MID_TERM | SHORT_TERM}  HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: <bce-authorization-string>

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 描述 是否必须
    startTime String 起始时间,采用UTC时间
    endTime String 结束时间,采用UTC时间
    timeInterval enum 时间间隔,有效值:LONG_TERM(每天)、MID_TERM(每小时)、SHORT_TERM(每5分钟)

    请求示例

    GET /v5/statistics/domain/traffic?startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-18T00%3a00%3a00Z&timeInterval=SHORT_TERM HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    domain String 直播域名
    startTime String 统计数据起始时间
    endTime String 统计数据截止时间
    timeInterval String 时间间隔
    statistics Object 统计数据数组
    +timestamp String 数据时间点
    +downstreamInByte Number 下行流量

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "startTime": "2016-01-01T00:00:00Z",
        "endTime": "2016-01-01T10:00:00Z",
        "periodInMinute": 20,
        "statistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "downstreamInByte": 100
            },{
                "timestamp": "2016-01-01T00:10:00Z",
                "downstreamInByte": 0
            },{
                "timestamp": "2016-01-01T00:20:00Z",
                "downstreamInByte": 150
            }
        ]
    }

    查询流量

    接口描述

    查询特定Domain的流量。

    请求语法

    GET /v<version>/statistics/domain/<playDomain>/traffic?startTime=<startTime>&endTime=<endTime>&timeInterval={LONG_TERM | MID_TERM | SHORT_TERM}  HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: <bce-authorization-string>

    请求头域

    无特殊请求头域。

    请求参数

    N/A

    请求示例

    GET /v5/statistics/domain/demo.domain.com/traffic?startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-18T00%3a00%3a00Z&timeInterval=SHORT_TERM HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    domain String 直播域名
    startTime String 统计数据起始时间,精确到秒级,按输入的时间间隔查询数据。
    endTime String 统计数据截止时间,精确到秒级,按输入的时间间隔查询数据。
    timeInterval String 时间间隔
    statistics Object 统计数据数组
    +timestamp String 数据时间点
    +downstreamInByte Number 下行流量

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "domain": "play.e-web.com.cn",
        "startTime": "2016-01-01T00:00:00Z",
        "endTime": "2016-01-01T10:00:00Z",
        "periodInMinute": 20,
        "statistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "downstreamInByte": 100
            },{
                "timestamp": "2016-01-01T00:10:00Z",
                "downstreamInByte": 0
            },{
                "timestamp": "2016-01-01T00:20:00Z",
                "downstreamInByte": 150
            }
        ]
    }

    查询所有Domain数据

    接口描述

    查询当前用户的所有Domain数据。

    请求语法

    GET /v<version>/statistics/domain/list?startTime=<startTime>&endTime=<endTime>&[orderBy=<orderRules>&keywordType=<keywordType>&keyword=<keyword>] HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: <bce-authorization-string>

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 描述 是否必须
    startTime Date 开始时间,精确到秒级,按输入的时间间隔查询数据。
    endTime Date 结束时间,精确到秒级,按输入的时间间隔查询数据。
    orderBy String 排序关键字。有效值:domain, downstream,duration,peak_bandwidth,peak_play_count,play_count。默认按流量降序排列
    keywordType String 搜索关键字类型。默认值:domain
    keyword String 搜索关键字,"",表示匹配所有

    请求示例

    GET /v5/statistics/domain/list?startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-18T00%3a00%3a00Z&orderBy=domain&keywordType=domain&keyword={keyword} HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    domainStatisticsList Object domain数据列表
    +domain String 直播域名
    +startTime String 统计数据起始时间
    +endTime String 统计数据截止时间
    +aggregate Object 统计数据聚合
    ++durationInMinute Number 直播总时长
    ++peakPlayCount Number 当天峰值播放人数
    ++peakBandwidthInBps Number 峰值带宽
    ++downstreamInByte Number 总下行流量
    ++playCount Number 累计播放请求数,等于用户累计播放时长,单位:分钟
    ++transcoding Number 累计转码时长(分钟)

    响应示例

        HTTP/1.1 200 OK
        x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
        Date: Fri, 03 Jul 2015 09:28:13 GMT
        Transfer-Encoding: chunked
        Content-Type: application/json;charset=UTF-8
        Cache-Control: no-cache
        {
            "domainStatisticsList": [
               {
                  "domain": "play.e-web.com.cn",
                  "startDate": 2016-01-01T00:00:00Z,
                  "endDate": 2016-01-05T00:00:00Z,
                  "aggregate": {
                      "durationInMinute": 200,
                      "peakPlayCount": 100,
                      "peakBandwidthInBps": 100,
                      "downstreamInByte": 10000,
                      "playCount": 200
                },
                {
                  "domain": "test.e-web.com.cn",
                  "startDate": 20160101,
                  "endDate": 20160201,
                  "aggregate": {
                      "durationInMinute": 200,
                      "peakPlayCount": 100,
                      "peakBandwidthInBps": 100,
                      "downstreamInByte": 10000,
                      "playCount": 200
                }
           ]
        }

    查询所有Stream数据

    接口描述

    查询当前用户特定Domain下的所有Stream数据。

    请求语法

    GET /v{version}/statistics/domain/{domain}/stream?app={app}&startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-18T00%3a00%3a00Z&orderBy=app&keywordType=stream&keyword={keyword} HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: <bce-authorization-string>

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 描述 是否必须 可选值 默认值
    Domain String 直播域名 - -
    app String app 名称 - -
    startTime Date 起始时间 - -
    endTime Date 结束时间 - -
    orderBy String 排序关键字,默认升序,加desc可以降序 app, downstream,duration,peak_bandwidth,
    peak_play_count,play_count,"app desc", "downstream desc", ...
    app
    keywordType String 搜索关键字类型 stream stream
    keyword String 搜索关键字 - ””,空表示匹配所有
    pageNo Int 页数 大于0的整数,例如1 1
    pageSize Int 每页的条数 大于0的整数,例如20 20

    请求示例

    GET /v5/statistics/domain/demo.domaim.com/stream?app=myapp&startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-18T00%3a00%3a00Z&orderBy=app&keywordType=stream&keyword={keyword} HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    streamStatisticsList Object stream数据列表
    +startDate String 统计数据起始日期
    +endDate String 统计数据截止日期
    +app String 应用名称
    +stream String 流名称
    +aggregate Object 统计数据聚合
    ++durationInMinute Number 直播总时长
    ++peakPlayCount Number 当天峰值播放人数
    ++peakBandwidthInBps Number 峰值带宽
    ++downstreamInByte Number 总下行流量
    ++playCount Number 累计播放请求数,等于用户累计播放时长,单位:分钟
    ++ totalCount Number 总共stream的数量,并不一定等于该列表的长度

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "totalCount": 236,
        "streamStatisticsList": [
           {
              "app": "testapp",
              "stream": "teststream",
              "startDate": 20160101,
              "endDate": 20160201,
              "aggregate": {
                  "durationInMinute": 200,
                  "peakPlayCount": 100,
                  "peakBandwidthInBps": 100,
                  "downstreamInByte": 10000,
                  "playCount": 200
            }, 
            {
              "app": "testapp1",
              "stream": "teststream1",
              "startDate": 20160101,
              "endDate": 20160201,
              "aggregate": {
                  "durationInMinute": 200,
                  "peakPlayCount": 100,
                  "peakBandwidthInBps": 100,
                  "downstreamInByte": 10000,
                  "playCount": 200
            }
       ]
    }

    查询特定Stream数据

    接口描述

    查询特定Domain下的特定Stream数据。

    请求语法

    GET /v<version>/statistics/domain/<playDomain>/app/<app>/stream/<stream>?startDate=<startDate>&endDate=<endDate>&aggregate={true | false} HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: <bce-authorization-string>

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 描述 是否必须
    playDomain String 直播域名
    app String 应用名称
    stream String 流名称
    startDate String 起始时间,默认为当天时间,若参数错误也默认为当天
    endDate String 结束时间,,默认为当天时间,若参数错误也默认为当天
    aggregate boolean 指定是否聚合,即数据聚合统计或按日统计。有效值:true、false,默认值: false。为true时聚合统计;否则按日统计

    请求示例

    GET /v5/statistics/domain/demo.domain.com/app/myapp/stream/mystream?startDate=20160118&endDate=20160128&aggregate=true HTTP/1.1
    host: lss.bj.baidubce.com
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    app String 应用名称
    stream String 流名称
    startDate String 起始日期
    endDate Number 结束日期
    statistics Object 统计数据数组
    +date String 数据日期
    +durationInMinute Number 直播总时长
    +peakPlayCount Number 当天峰值播放人数
    +peakBandwidthInBps Number 峰值带宽
    +downstreamInByte Number 总下行流量
    +playCount Number 累计播放请求数
    aggregate Object 聚合数据,只有请求参数设置aggregate=true时才返回。
    +durationInMinute Number 直播总时长
    +peakPlayCount Number 当天峰值播放人数
    +peakBandwidthInBps Number 峰值带宽
    +downstreamInByte Number 总下行流量
    +playCount Number 累计播放请求数

    响应示例

    aggregatestatistics数据仅返回一份,当aggregate=true时,返回aggregate类别数据;当aggregate=false时,返回statistics类别数据。

    • aggregate值为true

        HTTP/1.1 200 OK
        x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
        Date: Fri, 03 Jul 2015 09:28:13 GMT
        Transfer-Encoding: chunked
        Content-Type: application/json;charset=UTF-8
        Cache-Control: no-cache
        {
            "domain": "play.e-web.com.cn",
            "app": "test_stream",
            "stream": "test_stream",
            "startDate": 20160101,
            "endDate": 20160201,
            "aggregate": {
                "durationInMinute": 200,
                "peakPlayCount": 100,
                "peakBandwidthInBps": 100,
                "downstreamInByte": 10000,
                "playCount": 200
            }
        }
    • aggregate值为false

      HTTP/1.1 200 OK
      x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
      Date: Fri, 03 Jul 2015 09:28:13 GMT
      Transfer-Encoding: chunked
      Content-Type: application/json;charset=UTF-8
      Cache-Control: no-cache
      {
          "domain": "play.e-web.com.cn",
          "app": "test_stream",
          "stream": "test_stream",
          "startDate": 20160101,
          "endDate": 20160201,
          "statistics":[
              {
                  "date": "20160202",
                  "durationInMinute": 100,
                  "peakPlayCount": 100,
                  "peakBandwidthInBps": 100,
                  "downstreamInByte": 10000,
                  "playCount": 100
              },{
                  "date": "20160203",
                  "durationInMinute": 100,
                  "peakPlayCount": 100,
                  "peakBandwidthInBps": 100,
                  "downstreamInByte": 10000,
                  "playCount": 50
              }...
          ]
      }
         

    统计实时播放人数和带宽

    接口描述

    查询app下所有stream的实时播放人数和实时带宽,数据源采集频率每分钟一次,可能会有几分钟延迟情况。

    请求语法

    GET /v5/statistics/realtime/domain/{domain}/app/{app} HTTP/1.1
    accept-encoding: gzip, deflate
    x-bce-date: {utc-date-string}
    host: lss.bj.baidubce.com
    accept: */*
    connection: keep-alive
    x-bce-request-id: {bce-request-id}
    content-type: application/json
    authorization: {bce-authorization-string}

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 描述 是否必填 示例
    domain String 播放域名 play.bcelive.com
    app String app名称 live

    请求示例

    GET /v5/statistics/realtime/domain/play.bcelive.com/app/live HTTP/1.1
    content-length: 87
    accept-encoding: gzip, deflate
    x-bce-date: 2015-07-03T09:28:13Z
    connection: keep-alive
    accept: */*
    user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
    host: 10.105.97.172
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    content-type: application/json
    authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    bandwidthInBps Long 实时带宽数据,单位Byte
    playCount Long 实时播放人数(每分钟下行带宽/上行码率)
    date Date 当前时间
    stream String stream名称

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    [
        {
            “bandwidthInBps”: 272,
            “date”: “2017-02-20T11:11:32Z”,
            “playCount”: 8,
            “stream”: “stream1”
        },
        {
            “bandwidthInBps”: 326874087,
            “date”: “2017-02-20T11:11:32Z”,
            “playCount”: 174,
            “stream”: “stream2”
        },
        {
            “bandwidthInBps”: 541274250,
            “date”: “2017-02-20T11:11:32Z”,
            “playCount”: 325,
            “stream”: “stream3”
        }
    ] 

    特定domain上行流量

    接口描述

    查询多个domain(播放域名)的上行流量。

    请求语法

    GET /v5/statistics/domain/{domain}/uptraffic?startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-18T00%3a00%3a00Z&timeInterval=SHORT_TERM HTTP/1.1
    accept-encoding: gzip, deflate
    x-bce-date: {utc-date-string}
    host: 10.105.97.172
    accept: */*
    connection: keep-alive
    x-bce-request-id: {bce-request-id}
    content-type: application/json
    authorization: {bce-authorization-string}

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 是否必须 描述 可选值 默认值
    domain String 播放域名,多个域名以,分割 - -
    startTime Date 起始时间 - -
    endTime Date 结束时间 - -
    timeInterval String 时间间隔粒度 LONG_TERM/MID_TERM/SHORT_TERM; LONG_TERM:天粒度;MID_TERM:小时粒度;SHORT_TERM:5min粒度 -

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    startTime String 统计数据起始时间
    endTime String 统计数据截止时间
    timeInterval String 时间间隔粒度;时间间隔粒度SHORT_TERM:五分钟平均带宽;
    MID_TERM:小时内的max五分钟平均带宽;
    LONG_TERM:一天内的max五分钟平均带宽。
    statistics Object 统计数据数组
    +timestamp String 数据时间点
    +upstreamInByte Number 上行流量

    响应示例:

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "startTime": "2016-01-01T00:00:00Z",
        "endTime": "2016-01-01T10:00:00Z",
        "timeInterval ": LONG_TERM,
        "statistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "upstreamInByte": 100
            },{
                "timestamp": "2016-01-01T00:10:00Z",
                "upstreamInByte": 0
            },{
                "timestamp": "2016-01-01T00:20:00Z",
                "upstreamInByte": 150
            }
        ]
    }

    所有domain上行流量

    接口描述

    查询所有播放域名上行流量。

    请求语法

    GET /v5/statistics/domain/uptraffic?startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-18T00%3a00%3a00Z&timeInterval=SHORT_TERM HTTP/1.1
    accept-encoding: gzip, deflate
    x-bce-date: {utc-date-string}
    host: 10.105.97.172
    accept: */*
    connection: keep-alive
    x-bce-request-id: {bce-request-id}
    content-type: application/json
    authorization: {bce-authorization-string}

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 是否必须 描述 可选值 默认值
    startTime Date 起始时间 - -
    endTime Date 结束时间 - -
    timeInterval String 时间间隔粒度 LONG_TERM/MID_TERM/SHORT_TERM;
    LONG_TERM:天粒度;
    MID_TERM:小时粒度;
    SHORT_TERM:5min粒度
    -

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    startTime String 统计数据起始时间
    endTime String 统计数据截止时间
    timeInterval String 时间间隔粒度;时间间隔粒度SHORT_TERM:五分钟平均带宽;
    MID_TERM:小时内的max五分钟平均带宽;
    LONG_TERM:一天内的max五分钟平均带宽。
    statistics Object 统计数据数组
    +timestamp String 数据时间点
    +upstreamInByte Number 上行流量

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "startTime": "2016-01-01T00:00:00Z",
        "endTime": "2016-01-01T10:00:00Z",
        "timeInterval ": LONG_TERM,
        "statistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "upstreamInByte": 100
            },{
                "timestamp": "2016-01-01T00:10:00Z",
                "upstreamInByte": 0
            },{
                "timestamp": "2016-01-01T00:20:00Z",
                "upstreamInByte": 150
            }
        ]
    }

    特定domain上行带宽

    接口描述

    查询多个domain(播放域名)的上行带宽

    请求语法

    GET /v5/statistics/domain/{domain}/upbandwidth?startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-18T00%3a00%3a00Z&timeInterval=SHORT_TERM HTTP/1.1
    accept-encoding: gzip, deflate
    x-bce-date: {utc-date-string}
    host: 10.105.97.172
    accept: */*
    connection: keep-alive
    x-bce-request-id: {bce-request-id}
    content-type: application/json
    authorization: {bce-authorization-string}

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 是否必须 描述 可选值 默认值
    domain String 播放域名,多个域名以,分割 - -
    startTime Date 起始时间 - -
    endTime Date 结束时间 - -
    timeInterval String 时间间隔粒度 LONG_TERM/MID_TERM/SHORT_TERM;
    LONG_TERM:天粒度;
    MID_TERM:小时粒度;
    SHORT_TERM:5min粒度
    -

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    startTime String 统计数据起始时间
    endTime String 统计数据截止时间
    timeInterval String 时间间隔粒度;时间间隔粒度SHORT_TERM:五分钟平均带宽;
    MID_TERM:小时内的max五分钟平均带宽;
    LONG_TERM:一天内的max五分钟平均带宽。
    statistics Object 统计数据数组
    +timestamp String 数据时间点
    +bandwidthInBps Number 上行带宽

    响应示例:

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "startTime": "2016-01-01T00:00:00Z",
        "endTime": "2016-01-01T10:00:00Z",
        "timeInterval ": LONG_TERM,
        "statistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "bandwidthInBps": 100
            },{
                "timestamp": "2016-01-01T00:10:00Z",
                "bandwidthInBps": 0
            },{
                "timestamp": "2016-01-01T00:20:00Z",
                "bandwidthInBps": 150
            }
        ]
    }

    所有domain上行带宽

    接口描述

    查询用户下所有domain的上行带宽

    请求语法

    GET /v5/statistics/domain/upbandwidth?startTime=2016-01-18T00%3a00%3a00Z&endTime=2016-01-18T00%3a00%3a00Z&timeInterval=SHORT_TERM HTTP/1.1
    accept-encoding: gzip, deflate
    x-bce-date: {utc-date-string}
    host: 10.105.97.172
    accept: */*
    connection: keep-alive
    x-bce-request-id: {bce-request-id}
    content-type: application/json
    authorization: {bce-authorization-string}

    请求头域

    无特殊请求头域。

    请求参数

    参数 类型 是否必须 描述 可选值 默认值
    startTime Date 起始时间 - -
    endTime Date 结束时间 - -
    timeInterval String 时间间隔粒度 LONG_TERM/MID_TERM/SHORT_TERM;

    LONG_TERM:天粒度;
    MID_TERM:小时粒度;
    SHORT_TERM:5min粒度
    -

    响应头域

    无特殊响应头域。

    响应参数

    参数 类型 描述
    startTime String 统计数据起始时间
    endTime String 统计数据截止时间
    timeInterval String 时间间隔粒度;时间间隔粒度SHORT_TERM:五分钟平均带宽;
    MID_TERM:小时内的max五分钟平均带宽;
    LONG_TERM:一天内的max五分钟平均带宽。
    statistics Object 统计数据数组
    +timestamp String 数据时间点
    +bandwidthInBps Number 上行带宽

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
    Date: Fri, 03 Jul 2015 09:28:13 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Cache-Control: no-cache
    {
        "startTime": "2016-01-01T00:00:00Z",
        "endTime": "2016-01-01T10:00:00Z",
        "timeInterval ": LONG_TERM,
        "statistics":[
            {
                "timestamp": "2016-01-01T00:00:00Z",
                "bandwidthInBps": 100
            },{
                "timestamp": "2016-01-01T00:10:00Z",
                "bandwidthInBps": 0
            },{
                "timestamp": "2016-01-01T00:20:00Z",
                "bandwidthInBps": 150
            }
        ]
    }
    上一篇
    模板接口
    下一篇
    通知接口