帮助与文档

分域名回源请求数 下载PDF文档

接口地址

请求URL: stat/originRequest/eachDomain (GET)

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

接口描述

用于查询多个加速域名,并返回每个加速域名的回源请求数数据。

数据统计的时间粒度默认为5分钟。接口调用频率限制见响应头部(Response Header)。

输入参数

公有参数:用户的 token 可向值班同事获取。

请求参数(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:分钟粒度
minute5:5分钟粒度
hour:小时粒度
day:天粒度
不填充时,默认为minute5。
query_areastring指定查询范围:
all:查询国内+国外
cn:查询国内
abroad:查询国外
不填充时,默认为国内+国外。

调用示例

//请求需要经过URL编码处理。
curl -X GET "https://cdn.api.baishan.com/v2/stat/originRequest/eachDomain?token=xxx\
&domains=example.com,example2.com\
&start_time=2020-06-01%2010:00\
&end_time=2020-06-01%2011:00"

返回示例

json格式

正确示例
{
    "code": 0, //code为0,表示数据返回正常,非0时则不正常。
    "data": {
        "example.com": {
            "domain": "example.com",
            "data": []
        },
        "example2.com": {
            "domain": "example2.com",
            "data": [
                [
                    1590984900,//时间戳,返回时间戳按照升序排序。
                    364871//回源请求数的个数
                ],
                [
                    1590985200,
                    434121
                ],
                [
                    1590985500,
                    12
                ],
                [
                    1590985800,
                    16
                ]
                ...
            ]
        }
    }
}

错误示例
{
    "code": 400101,
    "message": "domain(life.com) is invalid"
}

响应头部(Response Header)

HTTP/1.0 200 OK
Api-Id:                82773601
Content-Type:          application/json; charset=utf-8
X-Ratelimit-Grad:      minute  //接口调用频率限制粒度(分/小时/天)
X-Ratelimit-Limit:     120  //当前每分钟请求次数上限
X-Ratelimit-Remaining: 120   //每分钟剩余请求次数
X-Retry-After:         34  //xx秒后重置当前粒度(分/小时/天)请求次数限制

http状态码说明

错误状态码说明
404您输入的 URL 错误
401鉴权错误,您的token错误,或者没有开通接口权限
400请求参数有误
200执行成功,返回请求的数据
5xx请联系值班同事
CopyRight © 2015-2024 BaishanCloud . All Rights Reserved.