统计接口
所有文档

          音视频直播 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 直播总时长
          +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
                  }
              ]
          }
          上一篇
          模板接口
          下一篇
          通知接口