请求URL: stat/httpcode (GET)
接口请求域名:
cdn.api.baishan.com
接口版本:v2
用于查询加速域名的HTTP状态码数据。
数据统计的时间粒度默认为5分钟。接口调用频率限制见响应头部(Response Header)。
接口限定单次请求不超过一个标量值: 域名数*一天数据点数*天数 <= 2880,大于该值时会提示:单次请求超过限制例如:请求2个域名, 请求时间为2天, 一天含288个数据点, 得到2*288*2 < 2880
公有参数:用户的 token 可向值班同事获取。
参数添加到在url的query部分,例如: ?key1=value1&key2=value2。
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
domains | string | 是 | 指定查询的加速域名,最多可一次性查询10个加速域名。 当查询多个加速域名时,返回多个加速域名的汇总数据。 传入all查询全部 |
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天。 |
grad | string | 否 | 指定数据统计的时间粒度查询:。 可选值:【 minute , minute5 , hour , day 】;minute :分钟粒度 minute5 :5分钟粒度hour :小时粒度 day :天粒度 不填充时,默认为minute5 。 |
//请求需要经过URL编码处理。
curl -X GET "https://cdn.api.baishan.com/v2/stat/httpcode?token=xxxx\
&domains=example.com,example2.com\
&start_time=2020-06-01%2012:16\
&end_time=2020-06-01%2012:35"
json格式
正确示例
{
"code": 0, //code为0时,表示数据返回正常。
"data": [
[
1590984900, //时间戳,按照升序排序。
{
"0": 2, //0状态码的个数。
"200": 860,
"302": 72,
"304": 1,
"403": 1217
}
],
[
1590985200,
{
"200": 252,
"301": 4,
"302": 66,
"304": 33,
"403": 10,
"404": 3
}
],
[
1590985500,
{
"0": 25,
"200": 608,
"302": 85,
"304": 80,
"404": 4
}
],
[
1590985800,
{
"0": 2,
"200": 693,
"302": 111,
"304": 2,
"404": 69
}
],
[
1590986100,
{
"0": 2,
"200": 762,
"301": 4,
"302": 133,
"304": 90,
"404": 113
}
]
]
}
错误示例
{
"code": 400101,
"message": "domain(life.com) is invalid"
}
HTTP/1.0 200 OK
Api-Id: 14426827
Content-Type: application/json; charset=utf-8
X-Ratelimit-Grad: minute //接口调用频率限制粒度(分/小时/天)
X-Ratelimit-Limit: 150 //当前每分钟请求次数上限
X-Ratelimit-Remaining: 10 //每分钟剩余请求次数
X-Retry-After: 20 //xx秒后重置当前粒度(分/小时/天)请求次数限制
错误状态码 | 说明 |
---|---|
404 | 您输入的 URL 错误 |
401 | 鉴权错误,您的token错误,或者没有开通接口权限 |
400 | 请求参数有误 |
200 | 执行成功,返回请求的数据 |
5xx | 请联系值班同事 |