请求URL: stat/originBandwidth/eachDomain (GET)
接口请求域名:
cdn.api.baishan.com
接口版本:v2
用于查询多个加速域名,并返回每个加速域名的回源带宽、流量数据。
数据统计的时间粒度默认为5分钟。接口调用频率限制见响应头部(Response Header)。
公有参数:用户的 token 可向值班同事获取。
参数添加到在url的query部分,例如: ?key1=value1&key2=value2。
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
domains | string | 是 | 指定查询的加速域名,最多可一次性查询10个加速域名。当查询多个加速域名时,返回每个加速域名的回源带宽、流量数据。 |
start_time | string | 是 | 指定查询起始时间,如: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_time | string | 是 | 指定查询结束时间,如: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天。 |
data_type | string | 否 | 指定数据指标查询:bandwidth :带宽,单位bpstraffic :流量,单位byte不填充时, 默认值为bandwidth。 |
grad | string | 否 | 指定数据统计的时间粒度查询:minute :1分钟粒度minute5 :5分钟粒度hour :小时粒度day :天粒度不填充时,默认为minute5。 |
query_area | string | 否 | 指定查询范围:all :查询国内+国外cn :查询国内abroad :查询国外不填充时,默认为国内+国外。 |
//请求需要经过URL编码处理。
curl -X GET "https://cdn.api.baishan.com/v2/stat/originBandwidth/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,表示数据返回正常。
"data": {
"example.com": {
"domain": "example.com",
"data": []
},
"example2.com": {
"domain": "example2.com",
"data": [
[
1590984900,//时间戳,按照升序排序。
214933321.12//返回data_type选择的数据。
],
[
1590985200,
207449380.64
],
...
]
}
}
}
错误示例
{
"code": 400101,
"message": "domain(life.com) is invalid"
}
HTTP/1.0 200 OK
Api-Id: 8335139
Content-Type: application/json; charset=utf-8
X-Ratelimit-Grad: minute //接口调用频率限制粒度(分/小时/天)
X-Ratelimit-Limit: 120 //当前每分钟请求次数上限
X-Ratelimit-Remaining: 99 //每分钟剩余请求次数
X-Retry-After: 32 //xx秒后重置当前粒度(分/小时/天)请求次数限制
错误状态码 | 说明 |
---|---|
404 | 您输入的 URL 错误 |
401 | 鉴权错误,您的 token 可能是不对的 |
400 | 请求参数有误 |
200 | 执行成功,返回请求的数据 |
5xx | 请联系值班同事 |