查询多域名在各ISP各省的IPV6请求数

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

适用产品

网页加速、下载分发、动态加速、全站加速、点播分发、直播分发、上传加速、移动加速、S-P2P、PCDN、应用性能管理、WEB应用防火墙、BotGuard爬虫管理、WSS、DMS、DDoS云清洗、应用安全加速解决方案、IPv6一体化解决方案、电商安全加速解决方案、金融安全加速解决方案、政企安全加速解决方案、应用安全解决方案、区块链安全加速解决方案、IPv6安全加速解决方案

接口描述

根据访客访问日志，查询域名在各ISP各省份不同IP类型的请求数支持语言请求头Accept-Language，只支持zh-CN、en-US，默认为zh-CN。Accept-Language：en-US时，省份及运营商入参及返回都为code，否则返回的为中文。

调用URL： https://open.chinanetcenter.com/api/report/request/isp-province/ipv6
调用方法：POST
数据延迟：3-5h

调用频率

单用户调用频率：300/5min

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

请求参数

Body 参数

参数名称	描述
dateFromString	开始时间： 1.时间格式为yyyy-MM-ddTHH:mm:ss+08:00，例如，2016-12-02T10:00:00+08:00（为北京时间2016年12月2日10点0分0秒）; 2.不能大于当前时间; 3.最多可获取最近半年（183天）的数据。
dateToString	结束时间： 1.时间格式yyyy-MM-ddTHH:mm:ss+08:00; 2.结束时间需大于开始时间，结束时间如果大于当前时间，取当前时间; 3.dateFrom，dateTo二者都未传，默认查询过去的24小时，如仅有一个未传，抛异常; 4.允许查询最大时间间隔：1天，即dateFrom和dateTo相差不能超过1天。（可联系技术支持调整）
domainList	域名： 1.可传递域名数量上限默认为200个（可联系技术支持调整）; 2.自动过滤掉无效域名（如传递非法域名，会被过滤掉，查询结果只返回有效域名的数据）。
dataIntervalString	数据粒度： 1.支持5m（5分钟）、1h（1小时） 2.不传默认5m。
provinceList	省份 1.未传递province时：查询所有省份，返回的数据按照所有省份聚合。 2.有传递province时：省份可传中文或code。省份信息码表详见概览页附录说明章节 3.支持语言请求头Accept-Language，只支持zh-CN、en-US，默认为zh-CN。Accept-Language：en-US时，省份及运营商入参及返回都为code，否则返回的为中文。
ispList	运营商： 1.未传递isp时：查询所有isp，返回的数据按照所有运营商聚合。 2.有传递isp时：运营商可传中文或code。运营商信息码表详见概览页附录说明章节
IPTypeString	IP类型： 1.可选值为 IPV6、IPV4; 2.不传默认查询全部
groupByList	分组关键词： 1.默认聚合展示; 2.可选值为domain.province.isp，可传入多个值; 3.传入关键词则代表需要按照关键词对应的值展示明细; 例如groupBy传入isp，则isp维度需要明细展示;当没有传递isp，则代表isp聚合展示，同时isp节点则不返回。其他province和domain相同逻辑。例如：传递'groupBy': ['domain','province']，则ispData下的isp节点无需返回。 { 'domain': 'www.aaaa.com', 'ispData': [ { 'isp': '中国电信', 'provinceData': [....] }]}

返回参数

Body 参数

参数名称	描述
- resultList
domainString	域名
- ispDataList
ispString	运营商
- provinceDataList
provinceString	省份
- requestDataList
timestampString	时间， 1.查询的数据粒度为5m时，格式为yyyy-MM-dd HH:mm；每一个时间片数据值代表的是前一个时间粒度范围内的数据值。一天开始的时间片是yyyy-MM-dd 00:05，最后一个时间片是（yyyy-MM-dd+1） 00:00； 2.查询的数据粒度为1h时，格式为yyyy-MM-dd HH；每一个时间片数据值代表的是前一个时间粒度范围内的数据值。一天开始的时间片是yyyy-MM-dd 01，最后一个时间片是（yyyy-MM-dd+1） 00； 3.返回开始时间和结束时间包含的时间片。
valueString	请求数

错误码

错误代码（code）	描述（message）	HTTP状态码	语义
MissingBody	This operation requires a body. Ensure that the body is present and the Content-Type header is set.	400	请求体没有传递
NotAcceptable	The accept header specified in your request is not acceptable.	400	Accept请求头不支持，接口仅支持json和xml格式，默认为json格式
InvalidHTTPRequest	There was an error in the body of your HTTP request.	400	请求体格式错误
InvalidDatePeriod	The date specified is invalid.	400	dateFrom或dateTo不符合规范
DateSpanError	You cannot specify a period greater than 7.	400	dateFrom和dateTo相差超过7天
DomainsExcessive	The number of domain is excessive once.	403	传递的域名个数超过账号限制
PARAM_INVALID	param: groupBy is null or invalid.	400	参数groupBy不符合规范
InternalError	We encountered an internal error. Please try again.	500	系统发生错误
PARAM_INVALID	param: domain is null or invalid.	400	参数domain不符合规范
PARAM_INVALID	param: dataInterval is null or invalid.	400	参数dataInterval不符合规范
PARAM_INVALID	param: province is null or invalid.	400	参数province不符合规范
ARAM_INVALID	param: isp is null or invalid.	400	参数isp不符合规范
PARAM_INVALID	param: IPType is null or invalid.	400	参数IPType不符合规范

示例

XML

请求示例 复制代码 复制成功#!/bin/bash # 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/isp-province/ipv6" \ -X "POST" \ -H "X-Time-Zone:GMT+08:00" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/xml" \ -d '{"dateFrom":"2019-01-01T00:00:00+08:00","dateTo":"2019-01-02T24:00:00+08:00","domain":["test.com"],"dataInterval":"5m","province":["北京","天津"],"isp":["中国电信"],"IPType":"IPV6","groupBy":["domain","isp","province"] }'

#!/bin/bash
# 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/isp-province/ipv6" \
-X "POST" \
-H "X-Time-Zone:GMT+08:00" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/xml" \
-d '{"dateFrom":"2019-01-01T00:00:00+08:00","dateTo":"2019-01-02T24:00:00+08:00","domain":["test.com"],"dataInterval":"5m","province":["北京","天津"],"isp":["中国电信"],"IPType":"IPV6","groupBy":["domain","isp","province"]
}'

返回示例 复制代码 复制成功<?xml version="1.0" encoding="UTF-8"?> <report> <result> <domain-isp-data> <domain>test.com</domain> <isp-data> <isp-province-data> <isp>中国电信</isp> <province-data> <province-measure-data> <province>北京</province> <request-data> <detail> <timestamp>2019-01-01 14:05</timestamp> <value>28224</value> </detail> <detail> <timestamp>2019-01-01 14:10</timestamp> <value>28224</value> </detail> </request-data> </province-measure-data> <province-measure-data> <province>天津</province> <request-data> <detail> <timestamp>2019-01-01 14:05</timestamp> <value>9408</value> </detail> <detail> <timestamp>2019-01-01 14:10</timestamp> <value>9408</value> </detail> </request-data> </province-measure-data> </province-data> </isp-province-data> </isp-data> </domain-isp-data> </result> </report>

<?xml version="1.0" encoding="UTF-8"?>
 
<report>
    <result>
        <domain-isp-data>
            <domain>test.com</domain> 
            <isp-data>
                <isp-province-data>
                    <isp>中国电信</isp> 
                    <province-data>
                        <province-measure-data>
                            <province>北京</province> 
                            <request-data>
                                <detail>
                                    <timestamp>2019-01-01 14:05</timestamp> 
                                    <value>28224</value>
                                </detail> 
                                <detail>
                                    <timestamp>2019-01-01 14:10</timestamp> 
                                    <value>28224</value>
                                </detail>
                            </request-data>
                        </province-measure-data> 
                        <province-measure-data>
                            <province>天津</province> 
                            <request-data>
                                <detail>
                                    <timestamp>2019-01-01 14:05</timestamp> 
                                    <value>9408</value>
                                </detail> 
                                <detail>
                                    <timestamp>2019-01-01 14:10</timestamp> 
                                    <value>9408</value>
                                </detail>
                            </request-data>
                        </province-measure-data>
                    </province-data>
                </isp-province-data>
            </isp-data>
        </domain-isp-data>
    </result>
</report>

JSON中文示例

请求示例 复制代码 复制成功#!/bin/bash # 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/isp-province/ipv6" \ -X "POST" \ -H "X-Time-Zone:GMT+08:00" \ -H "Accept-Language: zh-CN" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{"dateFrom":"2019-01-01T00:00:00+08:00","dateTo":"2019-01-02T24:00:00+08:00","domain":["test.com"],"dataInterval":"5m","province":["北京","天津"],"isp":["中国电信"],"IPType":"IPV6","groupBy":["domain","isp","province"] }'

#!/bin/bash
# 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/isp-province/ipv6" \
-X "POST" \
-H "X-Time-Zone:GMT+08:00" \
-H "Accept-Language: zh-CN" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '{"dateFrom":"2019-01-01T00:00:00+08:00","dateTo":"2019-01-02T24:00:00+08:00","domain":["test.com"],"dataInterval":"5m","province":["北京","天津"],"isp":["中国电信"],"IPType":"IPV6","groupBy":["domain","isp","province"]
}'

返回示例 复制代码 复制成功{ "result":[ { "domain":"test.com", "ispData":[ { "isp":"中国电信", "provinceData":[ { "province":"北京", "requestData":[ { "timestamp":"2019-01-01 00:05", "value":"0" }, { "timestamp":"2019-01-01 00:10", "value":"18" } ] } ] } ] } ] }

{
    "result":[
        {
            "domain":"test.com",
            "ispData":[
                {
                    "isp":"中国电信",
                    "provinceData":[
                        {
                            "province":"北京",
                            "requestData":[
                                {
                                    "timestamp":"2019-01-01 00:05",
                                    "value":"0"
                                },
                                {
                                    "timestamp":"2019-01-01 00:10",
                                    "value":"18"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

JSON英文示例

请求示例 复制代码 复制成功#!/bin/bash # 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/isp-province/ipv6" \ -X "POST" \ -H "X-Time-Zone:GMT+08:00" \ -H "Accept-Language: en-US" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{"dateFrom":"2019-01-01T00:00:00+08:00","dateTo":"2019-01-02T24:00:00+08:00","domain":["test.com"],"dataInterval":"5m","province":["beijing","tianjin"],"isp":["dx"],"IPType":"IPV6","groupBy":["domain","isp","province"] }'

#!/bin/bash
# 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/isp-province/ipv6" \
-X "POST" \
-H "X-Time-Zone:GMT+08:00" \
-H "Accept-Language: en-US" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '{"dateFrom":"2019-01-01T00:00:00+08:00","dateTo":"2019-01-02T24:00:00+08:00","domain":["test.com"],"dataInterval":"5m","province":["beijing","tianjin"],"isp":["dx"],"IPType":"IPV6","groupBy":["domain","isp","province"]
}'

返回示例 复制代码 复制成功{ "result":[ { "domain":"test.com", "ispData":[ { "isp":"dx", "provinceData":[ { "province":"beijing", "requestData":[ { "timestamp":"2019-01-01 00:05", "value":"0" }, { "timestamp":"2019-01-01 00:10", "value":"18" } ] } ] } ] } ] }

{
    "result":[
        {
            "domain":"test.com",
            "ispData":[
                {
                    "isp":"dx",
                    "provinceData":[
                        {
                            "province":"beijing",
                            "requestData":[
                                {
                                    "timestamp":"2019-01-01 00:05",
                                    "value":"0"
                                },
                                {
                                    "timestamp":"2019-01-01 00:10",
                                    "value":"18"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

本篇文档内容对您是否有帮助？

有帮助

我要反馈

CDN

云视频

安全

计算

存储

网络

数据库

域名服务

管理与部署

灾备

互联网中间件

应用与服务

云备源

用户服务

API

备案

查询多域名在各ISP各省的IPV6请求数

适用产品

接口描述

调用频率

请求参数

Body 参数

返回参数

Body 参数

错误码

示例

目录

热门产品与方案

快速入口

支持与服务

投资者关系

法律申明

关于网宿

联系我们

业务咨询