统计接口

查询统计数据

接口描述

查询特定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 /internal/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 选填 搜索关键字 - ””,空表示匹配所有

请求示例

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