查询多域名在各ISP各省份流量及带宽

接口描述

查询多域名在各ISP各省份流量及带宽

调用URL： https://open.chinanetcenter.com/api/report/flow/isp-province
调用方法：POST
数据延迟：5~15min

调用频率

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

请求参数

Body 参数

参数名称	描述
dateFromString	开始时间 1.格式为yyyy-MM-ddTHH:mm:ss+08:00; 2.必须大于当前时间-183天,并且小于当前时间和dateTo; 3.dateFrom和dateTo相差不能超过7天(可联系技术人员调整); 4.dateFrom和dateTo要么都传递,要么都不传递; 5.dateFrom和dateTo都未传递,则默认查询过去24小时的数据;
dateToString	结束时间 1.格式为yyyy-MM-ddTHH:mm:ss+08:00; 2.必须大于dateFrom;如果大于当前时间,则重新赋值为当前时间;
*domainList	域名:可传递域名数量上限默认为20个(可联系技术支持调整),未传递该入参时查询账号下所有域名,但当账号下域名数量超过限制时不可查询(报错)。
dataIntervalString	数据粒度,5m:5分钟粒度,1h:1小时粒度
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。运营商信息码表详见概览页附录说明章节
groupByList	分组维度 1.可选值为domain、province、isp,可传入多个值; 2.有传入则按照该维度展示明细数据;

返回参数

Body 参数

参数名称	描述
- resultList	结果
domainString	域名
- ispDataList	ISP数据
ispString	运营商
- provinceDataList	省份数据
provinceString	省份
- flowDataList	流量数据
timestampString	时间
valueString	流量值,单位为MB,保留两位小数
bandwidthString	带宽值,单位为Mbps,保留两位小数

错误码

错误代码（code）	描述（message）	HTTP状态码	语义
NotAcceptable	The accept header specified in your request is not acceptable.	400	Accept请求头不支持，接口仅支持json和xml格式，默认为json格式
MissingBody	This operation requires a body. Ensure that the body is present and the Content-Type header is set.	400	请求体没有传递
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不符合规范
PARAM_INVALID	param: isp is null or invalid.	400	参数isp不符合规范

示例

XML

请求示例 复制代码 复制成功#!/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/flow/isp-province" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/xml" \ -d '{ "dateFrom": "2016-12-02T10:00:00+08:00", "dateTo": "2016-12-03T10:00:00+08:00", "domain": [ "www.test.com" ], "dataInterval": "5m", "province": [ "北京", "天津" ], "isp": [ "中国电信" ], "groupBy": [ "domain", "isp", "province" ] }'

#!/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/flow/isp-province" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/xml" \
-d '{
    "dateFrom": "2016-12-02T10:00:00+08:00",
    "dateTo": "2016-12-03T10:00:00+08:00",
    "domain": [
        "www.test.com"
    ],
    "dataInterval": "5m",
    "province": [
        "北京",
        "天津"
    ],
    "isp": [
        "中国电信"
    ],
    "groupBy": [
        "domain",
        "isp",
        "province"
    ]
}'

返回示例 复制代码 复制成功<?xml version="1.0" encoding="utf-8"?> <report> <result> <domain-isp-data> <domain>www.test.com</domain> <isp-data> <isp-province-data> <isp>中国电信</isp> <province-data> <province-measure-data> <province>北京</province> <flow-data> <detail> <timestamp>2016-10-13 00:00</timestamp> <value>88.52</value> <bandwidth>8.52</bandwidth> </detail> <detail> <timestamp>2016-10-13 00:05</timestamp> <value>88.52</value> <bandwidth>8.52</bandwidth> </detail> </flow-data> </province-measure-data> <province-measure-data> <province>天津</province> <flow-data> <detail> <timestamp>2016-10-13 00:00</timestamp> <value>88.52</value> <bandwidth>8.52</bandwidth> </detail> <detail> <timestamp>2016-10-13 00:05</timestamp> <value>88.52</value> <bandwidth>8.52</bandwidth> </detail> </flow-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>www.test.com</domain>
            <isp-data>
                <isp-province-data>
                    <isp>中国电信</isp>
                    <province-data>
                        <province-measure-data>
                            <province>北京</province>
                            <flow-data>
                                <detail>
                                    <timestamp>2016-10-13 00:00</timestamp>
                                    <value>88.52</value>
                                    <bandwidth>8.52</bandwidth>
                                </detail>
                                <detail>
                                    <timestamp>2016-10-13 00:05</timestamp>
                                    <value>88.52</value>
                                    <bandwidth>8.52</bandwidth>
                                </detail>
                            </flow-data>
                        </province-measure-data>
                        <province-measure-data>
                            <province>天津</province>
                            <flow-data>
                                <detail>
                                    <timestamp>2016-10-13 00:00</timestamp>
                                    <value>88.52</value>
                                    <bandwidth>8.52</bandwidth>
                                </detail>
                                <detail>
                                    <timestamp>2016-10-13 00:05</timestamp>
                                    <value>88.52</value>
                                    <bandwidth>8.52</bandwidth>
                                </detail>
                            </flow-data>
                        </province-measure-data>
                    </province-data>
                </isp-province-data>
            </isp-data>
        </domain-isp-data>
    </result>
</report>

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/flow/isp-province" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -H "Accept-Language: zh-CN" \ -d '{ "dateFrom": "2016-12-02T10:00:00+08:00", "dateTo": "2016-12-03T10:00:00+08:00", "domain": [ "www.test.com" ], "dataInterval": "5m", "province": [ "北京", "天津" ], "isp": [ "中国电信" ], "groupBy": [ "domain", "isp", "province" ] }'

#!/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/flow/isp-province" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-H "Accept-Language: zh-CN" \
-d '{
    "dateFrom": "2016-12-02T10:00:00+08:00",
    "dateTo": "2016-12-03T10:00:00+08:00",
    "domain": [
        "www.test.com"
    ],
    "dataInterval": "5m",
    "province": [
        "北京",
        "天津"
    ],
    "isp": [
        "中国电信"
    ],
    "groupBy": [
        "domain",
        "isp",
        "province"
    ]
}'

返回示例 复制代码 复制成功{ "result": [ { "domain": "www.test.com", "ispData": [ { "isp": "中国电信", "provinceData": [ { "province": "北京", "flowData": [ { "timestamp": "2016-10-13 00:00", "value": "88.52", "bandwidth": "8.52" }, { "timestamp": "2016-10-13 00:05", "value": "88.52", "bandwidth": "8.52" } ] }, { "province": "天津", "flowData": [ { "timestamp": "2016-10-13 00:00", "value": "88.52", "bandwidth": "8.52" }, { "timestamp": "2016-10-13 00:05", "value": "88.52", "bandwidth": "8.52" } ] } ] } ] } ] }

{
    "result": [
        {
            "domain": "www.test.com",
            "ispData": [
                {
                    "isp": "中国电信",
                    "provinceData": [
                        {
                            "province": "北京",
                            "flowData": [
                                {
                                    "timestamp": "2016-10-13 00:00",
                                    "value": "88.52",
                                    "bandwidth": "8.52"
                                },
                                {
                                    "timestamp": "2016-10-13 00:05",
                                    "value": "88.52",
                                    "bandwidth": "8.52"
                                }
                            ]
                        },
                        {
                            "province": "天津",
                            "flowData": [
                                {
                                    "timestamp": "2016-10-13 00:00",
                                    "value": "88.52",
                                    "bandwidth": "8.52"
                                },
                                {
                                    "timestamp": "2016-10-13 00:05",
                                    "value": "88.52",
                                    "bandwidth": "8.52"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

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/flow/isp-province" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -H "Accept-Language: en-US" \ -d '{ "dateFrom": "2016-12-02T10:00:00+08:00", "dateTo": "2016-12-03T10:00:00+08:00", "domain": [ "www.test.com" ], "dataInterval": "5m", "province": [ "beijing", "tianjin" ], "isp": [ "dx" ], "groupBy": [ "domain", "isp", "province" ] }'

#!/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/flow/isp-province" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-H "Accept-Language: en-US" \
-d '{
    "dateFrom": "2016-12-02T10:00:00+08:00",
    "dateTo": "2016-12-03T10:00:00+08:00",
    "domain": [
        "www.test.com"
    ],
    "dataInterval": "5m",
    "province": [
        "beijing",
        "tianjin"
    ],
    "isp": [
        "dx"
    ],
    "groupBy": [
        "domain",
        "isp",
        "province"
    ]
}'

返回示例 复制代码 复制成功{ "result": [ { "domain": "www.test.com", "ispData": [ { "isp": "dx", "provinceData": [ { "province": "beijing", "flowData": [ { "timestamp": "2016-10-13 00:00", "value": "88.52", "bandwidth": "8.52" }, { "timestamp": "2016-10-13 00:05", "value": "88.52", "bandwidth": "8.52" } ] }, { "province": "tianjin", "flowData": [ { "timestamp": "2016-10-13 00:00", "value": "88.52", "bandwidth": "8.52" }, { "timestamp": "2016-10-13 00:05", "value": "88.52", "bandwidth": "8.52" } ] } ] } ] } ] }

{
    "result": [
        {
            "domain": "www.test.com",
            "ispData": [
                {
                    "isp": "dx",
                    "provinceData": [
                        {
                            "province": "beijing",
                            "flowData": [
                                {
                                    "timestamp": "2016-10-13 00:00",
                                    "value": "88.52",
                                    "bandwidth": "8.52"
                                },
                                {
                                    "timestamp": "2016-10-13 00:05",
                                    "value": "88.52",
                                    "bandwidth": "8.52"
                                }
                            ]
                        },
                        {
                            "province": "tianjin",
                            "flowData": [
                                {
                                    "timestamp": "2016-10-13 00:00",
                                    "value": "88.52",
                                    "bandwidth": "8.52"
                                },
                                {
                                    "timestamp": "2016-10-13 00:05",
                                    "value": "88.52",
                                    "bandwidth": "8.52"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

CDN

云视频

安全

计算

存储

网络

数据库

域名服务

管理与部署

灾备

互联网中间件

应用与服务

云备源

用户服务

API

备案

查询多域名在各ISP各省份流量及带宽

适用产品

接口描述

调用频率

请求参数

Body 参数

返回参数

Body 参数

错误码

示例

目录

热门产品与方案

快速入口

支持与服务

投资者关系

法律申明

关于网宿

联系我们

业务咨询