帮助与文档

traffic-分域名-请求数 下载PDF文档

接口地址

请求URL: stat/traffic/request/eachDomain (GET)

接口请求域名: cdn.api.baishan.com
接口版本: v2

接口描述

分域名的请求数接口
注意:

输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。

请求参数(GET)

参数添加到在url的query部分,例如: ?key1=value1&key2=value2

参数名数据类型是否必须说明
domainsstring指定查询的加速域名,最多可一次性查询10个加速域名。当查询多个加速域名时,返回每个加速域名的请求数数据。
start_timestring指定查询起始时间,如:2020-06-01 10:00、2020-06-01,其中2020-06-01代表以 2020-06-01 00:00:00作为起始时间。
返回结果大于等于指定时间,根据指定时间粒度不同,会进行向前规整,如:2020-06-01 10:03在按5分钟的时间粒度查询时,返回的第一个数据对应时间点为2020-06-01 10:00。
起始时间与结束时间间隔小于等于31天。
end_timestring指定查询结束时间,如:2020-06-02 10:00、2020-06-02,其中2020-06-02代表以 2020-06-02 23:59:59作为结束时间。
返回结果小于等于指定时间,根据指定时间粒度不同,会进行向前规整,如:2020-06-02 10:17在按5分钟的时间粒度查询时,返回的第一个数据对应时间点为2020-06-02 10:15:00。
起始时间与结束时间间隔小于等于31天。
gradstring指定数据统计的时间粒度查询:
minute:1分钟粒度:查询时间跨度为一天
minute5:5分钟粒度:查询时间跨度为31天
hour:小时粒度:查询时间跨度为31天
day:天粒度:查询时间跨度为93三个月
不填充时,默认为minute5。
ip_protocolstring指定IP协议查询:
ipv4:查询ipv4的统计数据
ipv6:查询ipv6的统计数据
不填充时,默认返回ipv4和ipv6的汇总数据。
protocol_typestring指定http协议查询:
http:查询http的统计数据
https:查询https的统计数据
不填充时,默认返回http和https的汇总数据。
query_areastring指定查询范围:
all:查询国内+国外
cn:查询国内
abroad:查询国外
不填充时,默认为国内+国外。

调用示例:

curl -X GET "https://cdn.api.baishan.com/v2/stat/traffic/request/eachDomain?domains=example1.com,example2.com&start_time=2024-01-25+15%3A00&end_time=2024-01-25+15%3A05&grad=minute&query_area=all&ip_protocol=ipv4&token=xxx"

返回示例

json格式

{
    "code": 0,
    "data": {
        "example1.com": {
            "domain": "example1.com",
            "data": []
        },
        "example2.com": {
            "domain": "example2.com",
            "data": [
                [
                    1706166000000,
                    2
                ],
                [
                    1706166060000,
                    1
                ],
                [
                    1706166120000,
                    1
                ],
                [
                    1706166180000,
                    0
                ],
                [
                    1706166240000,
                    7
                ],
                [
                    1706166300000,
                    2
                ]
            ]
        }
    }
}

响应(Response Header)

HTTP/1.0 200 OK
Api-Id:                0
Content-Type:          application/json; charset=utf-8
X-Ratelimit-Grad:      minute
X-Ratelimit-Limit:     300
X-Ratelimit-Remaining: 297
X-Retry-After:         35
CopyRight © 2015-2024 BaishanCloud . All Rights Reserved.