CDN加速

文档中心 API文档 查询多域名各省各ISP请求数

查询多域名各省各ISP请求数

更新时间:2022-05-26 16:51:11

适用产品

网页加速

接口描述

查询多域名在各ISP各省份请求数,仅包含中国用户信息

推荐使用 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时,默认查询所有加速区域。
province
List省份: 1.未传递province时:查询所有省份,返回的数据按照所有省份聚合。 2.有传递province时:只能传单个。传递省份中文名称,如:北京、上海。省份信息码表详见概览页附录说明章节
isp
List运营商: 1.未传递isp时:查询所有isp,返回的数据按照所有运营商聚合。 2.有传递isp时:只能传单个。传递运营商中文名称,如:中国电信、中国铁通。运营商信息码表详见概览页附录说明章节
groupBy
List分组维度 可选值为domain、province、isp,可传入多个值; 有传入则按照该维度展示明细数据; 没传默认全部聚合。

返回参数

Body 参数

参数名称类型描述
result
Listundefined
domain
String域名
ispData
Listundefined
isp
String运营商
provinceData
Listundefined
province
String省份
totalRequest
String省份运营商的请求总数
requestData
Listundefined
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状态码语义
MissingBodyThis operation requires a body. Ensure that the body is present and the Content-Type header is set.400请求体没有传递
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/domain/request/isp-province" \
  -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.test.com"],
       "province":[
           "福建"
         ],
      "isp":[
        "中国电信"
       ],
	"dataInterval": "5m",
	"groupBy": ["domain","province","isp"]
}'
返回示例
复制代码 复制成功
{
    "code":"0",
    "data":[
        {
            "domain":"www.test.com",
            "ispData":[
                {
                    "isp":"中国电信",
                    "provinceData":[
                        {
                            "details":[
                                {
                                    "request":"233231",
                                    "timestamp":"2022-05-19 12:00"
                                },
                                {
                                    "request":"233235",
                                    "timestamp":"2022-05-19 12:05"
                                }
                            ],
                            "province":"福建",
                            "totalRequest":"466466"
                        }
                    ]
                }
            ]
        }
    ],
    "message":"success"
}
本篇文档内容对您是否有帮助?
有帮助
没帮助
提交成功!非常感谢您的反馈,我们会继续努力做到更好!