CDN加速

文档中心 API文档 请求数报表 查询多域名的各国家区域请求数

查询多域名的各国家区域请求数

更新时间:2022-05-26 17:27:05

适用产品

网页加速

接口描述

查询多域名在各国家区域请求数

推荐使用 Open API在线调试

Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试

请求参数

Body 参数

参数名称类型必填描述
dateFrom
String开始时间: 1.格式为yyyy-MM-ddTHH:mm:ss+08:00,例如,2016-12-02T10:00:00+08:00(为北京时间2016年12月2日10点0分0秒); 2.不能大于当前时间; 3.最多可获取最近半年(183天)的数据。
dateTo
String结束时间: 1.格式为yyyy-MM-ddTHH:mm:ss+08:00; 2.结束时间需大于开始时间; 3.结束时间如果大于当前时间,取当前时间; 4.dateFrom,dateTo二者都未传,默认查询过去的24小时;如仅有一个未传,抛异常; 5.默认查询间隔7天,允许查询最大间隔:31天,即dateFrom和dateTo相差不能超过31天。
domain
List域名: 1.未传递domain时:查询账号下所有全部域名(域名超过20个则报错,可联系技术支持调整); 2.有传递domain时:域名最多支持传20个(可联系技术支持调整)。
areaCode
List加速区域: 未传递areaCode时,默认查询所有加速区域。
dataInterval
String数据粒度: 5m:5分钟粒度; 1h:1小时粒度; 1d:1天粒度。不传默认1天粒度
countryCode
List国家区域(含中国台湾、中国澳门、中国香港、中国大陆): 1.未传递countryCode时:查询全部国家区域; 2.有传递countryCode时:可传多个,如cn,in。可传递的值详见概览页附录说明章节
groupBy
List分组维度 可选值为domain、countryCode,可传入多个值; 有传入则按照该维度展示明细数据; 没传默认全部聚合。

返回参数

Body 参数

参数名称类型描述
result
List
domain
String域名
countryData
List
countryCode
String国家区域
totalRequest
String国家的请求总数
requestData
List
timestamp
String时间, 查询的数据粒度为5m时,格式为yyyy-MM-dd HH:mm;每一个时间片数据值代表的是前一个时间粒度范围内的数据值。一天开始的时间片是yyyy-MM-dd 00:05,最后一个时间片是(yyyy-MM-dd+1) 00:00; 查询的数据粒度为1h时,格式为yyyy-MM-dd HH;每一个时间片数据值代表的是前一个时间粒度范围内的数据值。一天开始的时间片是yyyy-MM-dd 01,最后一个时间片是(yyyy-MM-dd+1) 00; 查询的数据粒度为1d时,格式为yyyy-MM-dd;每一个时间片数据值代表的该天内的数据值; 返回开始时间和结束时间包含的时间片。
request
String请求数

错误码

错误代码(code)描述(message)HTTP状态码语义
NotAcceptableThe accept header specified in your request is not acceptable.400Accept请求头不支持,接口仅支持json和xml格式,默认为json格式
InvalidHTTPRequestThere was an error in the body of your HTTP request.400请求体格式错误
InvalidDatePeriodThe date specified is invalid.400dateFrom或dateTo不符合规范
DateSpanErrorYou cannot specify a period greater than xx minute(s).400dateFrom和dateTo相差超过限制值
DomainsExcessiveThe number of domain is excessive once.403传递的域名个数超过账号限制
PARAM_INVALIDparam: domain is null or invalid.400参数domain不符合规范
PARAM_INVALIDparam: dataInterval is null or invalid.400参数dataInterval不符合规范
PARAM_INVALIDparam: province is null or invalid.400参数province不符合规范
PARAM_INVALIDparam: isp is null or invalid.400参数isp不符合规范
PARAM_INVALIDparam: groupBy is null or invalid.400参数groupBy不符合规范
InternalErrorWe encountered an internal error. Please try again.500系统发生错误

示例

JSON
JSON
请求示例
复制代码 复制成功!
#!/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/request/country" \
  -X "POST" \
  -H "X-Time-Zone:GMT+08:00" \
  -u "$username:$password" \
  -H "Date: $date" \
  -H "Accept: application/json" \
  -d '{
"dateFrom": "2022-05-19T00:00:00+08:00",
"dateTo": "2022-05-19T20:00:00+08:00",
"domain":["www.test1.com"],
"dataInterval": "5m",
"groupBy": ["domain","countryCode"],
"countryCode": ["cn"]
}'
返回示例
复制代码 复制成功!
{
    "code":"0",
    "data":[
        {
            "countryData":[
                {
                    "countryCode":"cn",
                    "requestData":[
                        {
                            "request":"892668",
                            "timestamp":"2022-05-19 12:00"
                        },
                        {
                            "request":"1526643",
                            "timestamp":"2022-05-19 12:05"
                        },
                        {
                            "request":"368738",
                            "timestamp":"2022-05-19 12:10"
                        }
                    ],
                    "totalRequest":"2788049"
                }
            ],
            "domain":"www.test1.com"
        }
    ],
    "message":"success"
}