一．功能简介

  直播业务中，在线人数与每路流的实时带宽数据均可反映该路流的热度，为满足客户实时查询主播/节目热度，网宿提供频道带宽/流量查询API，可通过指定时间段内查询一个域名下指定流名的带宽或流量数据。
  下面将介绍单域名下多个直播流带宽/流量查询接口。

二．使用说明

  API 地址
  https://open.chinanetcenter.com/api/report/flow/stream/detail

  调用示例
  采用Post方式请求，具体示例如下：

curl -i --url "https://open.chinanetcenter.com/api/report/flow/stream/detail"
  -X POST 
  -u {user}:{password} 
  -H 'Date: Fri, 26 Oct 2012 06:33:26 GMT' 
  -H 'Accept: application/json'
  -d '{
"dateFrom": "2016-12-02T10:00:00+08:00",
"dateTo": "2016-12-03T10:00:00+08:00",
"domainStream": [{"domain": "www.baidu1.com", "stream": ["live/aaaaa","live/bbbbb"]}],
"dataInterval": "5m",
"dataType": "flow "
}'

  其中
  user=SI 账号

Date=` env LANG=en_US.UTF-8 date -u “+%a, %d %b %Y %H:%M:%S GMT”`
password=Base64(HMAC-SHA1(UTF-8(Date), UTF-8(API_KEY))
        =`echo -en "$DATE" | openssl dgst -sha1 -hmac "$API_KEY" -binary | openssl enc -base64`  

  入参参数说明

  数据返回

当提交datatype为flow时：
{ "domain": "www.abc.com",
  "details": [
  {"stream": "live/aaaaa",
"totalFlow": 222.22
"details": [
  { "timestamp": "2016-12-01 00:05 ","value": "123.11" },
  { "timestamp": "2016-12-01 00:10","value": "123.11"}]  
  }
  ]
}
当提交datatype为bandwidth时：
{ "domain": "www.abc.com",
  "details": [
  { "stream": "live/aaaaa",
    "bandwidthPeakValue": 200.22
    "details": [
  { "timestamp": "2016-12-01 00:05 ","value":   "123.11" },
  { "timestamp": "2016-12-01 00:10","value":   "123.11"}]
}
]
}

  出参参数说明

  错误返回码说明

三．应用场景

  所有直播业务中，直播平台需要了解指定时间段内单条流的带宽或流量数据。

四．注意事项

  1) Date为格林尼治标准时间。
  2) 鉴权所需APIKEY，可向网宿项目经理咨询。
  3) 开始时间不得大于接口调用当前时间，且开始和结束时间的间隔不得大于1天；
  4) 单次查询最多只可携带20个域名，若不带参数stream进行查询则返回所有流数据，若携带stream参数，流名个数上限为2000个。
  5) 当需要传入指定流名查询时，流名格式为发布点+流名，比如拉流url为rtmp://wstest.com/live/test，则传参为live/test。
  6) 当粒度选择为1分钟时，一天开始的时间片是yyyy-MM-dd 00:01，最后一个时间片是（yyyy-MM-dd+1） 00:00，五分钟粒度同理。
  7) 接口调用限制5分钟30次；