CDN加速

文档中心 API文档 查询多域名在各ISP各省份流量及带宽

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

更新时间:2022-07-07 17:12:57

适用产品

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

接口描述

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

推荐使用 Open API在线调试

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

请求参数

Body 参数

参数名称类型必填描述
dateFrom
String开始时间 1.格式为yyyy-MM-ddTHH:mm:ss+08:00; 2.必须大于当前时间-183天,并且小于当前时间和dateTo; 3.dateFrom和dateTo相差不能超过7天(可联系技术人员调整); 4.dateFrom和dateTo要么都传递,要么都不传递; 5.dateFrom和dateTo都未传递,则默认查询过去24小时的数据;
dateTo
String结束时间 1.格式为yyyy-MM-ddTHH:mm:ss+08:00; 2.必须大于dateFrom;如果大于当前时间,则重新赋值为当前时间;
domain
List域名:可传递域名数量上限默认为20个(可联系技术支持调整),未传递该入参时查询账号下所有域名,但当账号下域名数量超过限制时不可查询(报错)。
dataInterval
String数据粒度,5m:5分钟粒度,1h:1小时粒度
province
List省份中文名称,可选值为北京、上海、天津、重庆、河北、山西、河南、辽宁、吉林、黑龙江、内蒙古、江苏、山东、安徽、浙江、福建、湖北、湖南、广东、广西、江西、四川、海南、贵州、云南、西藏、陕西、甘肃、青海、宁夏、新疆、其它,可传入多个值,不传代表查询全部省份
isp
List运营商中文名称,可选值为中国电信、中国铁通、中国联通、中国教育网、中国移动、中国广电、长城宽带、E家宽、其它,可传入多个值,不传代表查询全部运营商
groupBy
List分组维度 1.可选值为domain、province、isp,可传入多个值; 2.有传入则按照该维度展示明细数据;

返回参数

Body 参数

参数名称类型描述
result
List结果
domain
String域名
ispData
ListISP数据
isp
String运营商
provinceData
List省份数据
province
String省份
flowData
List流量数据
timestamp
String时间
value
String流量值,单位为MB,保留两位小数
bandwidth
String带宽值,单位为Mbps,保留两位小数

错误码

错误代码(code)描述(message)HTTP状态码语义
NotAcceptableThe   accept header specified in your request is not acceptable.400Accept请求头不支持,接口仅支持json和xml格式,默认为json格式
MissingBodyThis   operation requires a body. Ensure that the body is present and the   Content-Type header is set.400请求体没有传递
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 7.400dateFrom和dateTo相差超过7天
DomainsExcessiveThe   number of domain is excessive once.403传递的域名个数超过账号限制
PARAM_INVALIDparam:   groupBy is null or invalid.400参数groupBy不符合规范
InternalErrorWe   encountered an internal error. Please try again.500系统发生错误
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不符合规范

示例

JSON
XML
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" \
-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"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}
本篇文档内容对您是否有帮助?
有帮助
没帮助
提交成功!非常感谢您的反馈,我们会继续努力做到更好!