CDN加速

文档中心 API文档 其他 查询多域名的推流时长

查询多域名的推流时长

更新时间:2021-01-08 10:50:04
适用产品:直播加速

接口描述

获取特定时间的指定域名的推流时长。数据存储时长:一年

请求参数

参数名称类型必填描述
timeString查询的结束时间 1.格式为yyyyMMdd; 2.必须小于当前系统时间; 3.不传时默认为系统当前时间;4.只能查询最近2年内数据。
modeString查询时间区间 1.取值范围为1~31的整数,单位为天; 2.不传时默认为7; (例如:time=20160622&mode=2,查询范围是2016-06-20到2016-06-21的数据)
请求体Array域名列表; 1.域名个数限制根据账号可调,默认为1个; 2.不传递则查询全部域名,同时接受域名数量上限限制;

返回参数

参数名称类型描述
domainString域名
progString流名
sumTimeNumber对应时间段内流名推流时长之和,单位为毫秒
startTimeString推流起始时间,格式为yyyyMMddHHmmss
endTimeString推流终止时间,格式为yyyyMMddHHmmss
durationNumber推流时长,单位为毫秒

错误码

错误代码(code)描述(message)HTTP状态码语义
NotAcceptableThe   accept header specified in your request is not acceptable.400Accept请求头不支持,接口仅支持json格式
PARAM_INVALIDparam:   mode is null or invalid.400参数mode不符合规范
DomainsExcessiveThe   number of domain is excessive once.403传递的域名个数超过限制
DomainNameIsRequiredThe   domain name is required.400参数体为空json数组
NoSuchDomainThe   specified domain does not exist.404传递的域名不存在或不属于当前调用账号
InternalErrorWe   encountered an internal error. Please try again.500系统发生错误

示例

示例说明
请求示例
复制
#!/bin/bash
# 请将示例中的(-H "X-Time-Zone") 参数设置为您希望在返回结果中获得的时区
# Please remember to change the param (-H "X-Time-Zone") in this demo to the TimeZone you want in response

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" \
-H "X-Time-Zone:GMT+08:00" \
-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
                          }
                      ]
                  }
              ]
          }
      ]
  }