文档中心 API文档 查询多域名IPv6/IPv4的带宽/请求数

查询多域名IPv6/IPv4的带宽/请求数

更新时间:2021-12-14 11:13:24

适用产品

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

接口描述

查询多域名IPv6/IPv4的带宽/请求数

推荐使用 Open API在线调试

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

请求参数

Body 参数

参数名称类型必填描述
dateFrom
String开始时间: 1.时间格式为yyyy-MM-ddTHH:mm:ss+08:00,例如,2021-05-19T10:00:00+08:00(为北京时间2021年5月19日10点0分0秒) 2.不能大于当前时间 3.最多可获取最近半年(183天)的数据
dateTo
String结束时间: 1.时间格式yyyy-MM-ddTHH:mm:ss+08:00 2.结束时间需大于开始时间,结束时间如果大于当前时间,取当前时间 3.dateFrom,dateTo二者都未传,默认查询过去的1小时;如仅有一个未传,抛异常 4.允许查询最大时间间隔:1天,即dateFrom和dateTo相差不能超过1天。(可联系技术支持调整)
domain
List域名: 1、可传递域名数量上限默认为20个(可联系技术支持调整); 2、自动过滤掉无效域名(如传递非法域名,会被过滤掉,查询结果只返回有效域名的数据)。
dataInterval
String数据粒度: 1、支持1m(1分钟)、5m(5分钟)、1h(1小时) 2、不传默认5m
queryBy
String1.可选值:bandwidth、request 2.不传默认bandwidth
groupBy
List可选值:domain 不传默认聚合所有频道数据

返回参数

Body 参数

参数名称类型描述
code
String请求结果状态码
message
String请求结果信息
data
List
domain
String域名,聚合全部域名数据不返回该字段
detailList
List请求结果的详细数据
timestamp
String时间片,返回开始时间和结束时间包含的时间片。 时间格式: 1/5分钟:yyyy-MM-dd HH:mm 1小时:yyyy-MM-dd HH
v4Value
StringIPv4数据
v6Value
StringIPv6数据

错误码

错误代码(code)描述(message)HTTP状态码语义
24102013The accept header specified in your request is not acceptable.400Accept请求头不支持,接口仅支持json和xml格式,默认为json格式
24102002There was an error in the body of your HTTP request.400请求体格式错误
24102006The date specified is invalid.400dateFrom或dateTo不符合规范或时间区间不合法
24102007You cannot specify a period greater than xx minutes.400dateFrom和dateTo相差超过限制值
24102021Date format error.400日期格式错误
24102019The request was rejected because the number of domain(xx) exceeds the limit (xx).400传递的域名个数超过账号限制
24102008param: domain is null or invalid.400参数domain不符合规范
24102008param: dataInterval is null or invalid.400参数dataInterval不符合规范
24102008param: queryBy is null or invalid.400参数queryBy不符合规范
24102008param: groupBy is null or invalid.400参数groupBy不符合规范
24102019The request was rejected because the number of domain(xx) exceeds the limit (xx)400域名个数超过限制
24102500We encountered an internal error. Please try again.500系统发生错误

示例

JSON
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-request/multi-ip-version" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '{
    "dateFrom": "2021-05-19T10:00:00+08:00",
    "dateTo": "2021-05-19T12:00:00+08:00",
    "domain": [
        "img.abc.com",
        "www.2222.com"
    ],
    "dataInterval": "1m",
    "queryBy": "request",
    "groupBy": [
        "domain"
    ]
}'
返回示例
复制代码 复制成功
{
    "code": "0",
    "message": "success",
    "data": [
        {
            "domain": "img.abc.com",
            "detailList": [
                {
                    "timestamp": "2021-05-19 10:00",
                    "v4Value": "212",
                    "v6Value": "10"
                },
                {
                    "timestamp": "2021-05-19 10:01",
                    "v4Value": "202",
                    "v6Value": "20"
                },
                {
                    "timestamp": "2021-05-19 10:02",
                    "v4Value": "310",
                    "v6Value": "30"
                },
                {
                    "timestamp": "2021-05-19 10:03",
                    "v4Value": "100",
                    "v6Value": "50"
                },
                {
                    "timestamp": "2021-05-19 10:04",
                    "v4Value": "130",
                    "v6Value": "70"
                },
                {
                    "timestamp": "2021-05-19 10:05",
                    "v4Value": "42",
                    "v6Value": "80"
                },
                {
                    "timestamp": "2021-05-19 10:06",
                    "v4Value": "232",
                    "v6Value": "90"
                },
                {
                    "timestamp": "2021-05-19 10:07",
                    "v4Value": "156",
                    "v6Value": "66"
                },
                {
                    "timestamp": "2021-05-19 10:08",
                    "v4Value": "401",
                    "v6Value": "99"
                }
            ]
        }
    ]
}
本篇文档内容对您是否有帮助?
有帮助
没帮助
提交成功!非常感谢您的反馈,我们会继续努力做到更好!