一．功能简介

  主播的推流时间和推流时长可以反应出主播的直播习惯，特别是大主播用户，而大主播的直播通常会带来更大的流量和带宽压力，因此需要重点保障，网宿推出主播推流时长API查询接口，可以提供主播推流开始时间，推流结束时间，以及推流时长，和推流时间汇总，供客户查询。

二． 使用说明

  网宿提供相应的API 接口给客户。具体API如下：
  https://open.chinanetcenter.com/api/report/duration/stream
  数据延迟：3-5h
  接口请求时，可携带如下参数：

  请求示例 json：

#!/bin/bash
username="example_username"
apiKey="example_apiKey"
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://open.chinanetcenter.com/api/report/duration/stream?time=20171101&mode=2" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '[
    "www.test.com"
]'

  返回参数：

  返回示例：

{
      "result":[
          {
                "domain":"www.test.com",
              "progDurations":[
                  {
                        "prog":"www.test.com/abc/steam01",
                        "sumTime":30646001,
                        "durationDetails":[
                          {
                                "startTime":"20170101100000",
                                "endTime":"20170101120000",
                                "duration":20323001
                          },
                          {
                              "startTime":"20170102100000",
                                "endTime":"20170102120000",
                                "duration":10323000
                          }
                      ]
                  },
                  {
                      "prog":"www.tet.com/abc/steam02",
                        "sumTime":60646018,
                        "durationDetails":[
                          {
                                "startTime":"20170101060000",
                                "endTime":"20170101080000",
                              "duration":30323009
                          },
                          {
                                "startTime":"20170102100000",
                                "endTime":"20170102120000",
                                "duration":30323009
                          }
                      ]
                  }
              ]
          }
      ]
  }

  错误码：

三． 应用场景

  所有直播业务中，直播平台需要了解主播推流时长等相关数据。

四．注意事项

  1) API 接口中两个参数之间用与号(&)隔开；
  2) 请不要在问号(?)后面带空格等不符合HTTP 协议的字符，如果在URL 或目录名中使用这些字符，请务必使用转义符(比如,空格的转义符为%20)；
  3) 接口调用限制5分钟100次；