帮助与文档

HTTP状态码查询 下载PDF文档

接口地址

请求URL: stat/httpcode (GET)

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

接口描述

用于查询加速域名的HTTP状态码数据。

数据统计的时间粒度默认为5分钟。接口调用频率限制见响应头部(Response Header)。
接口限定单次请求不超过一个标量值: 域名数*一天数据点数*天数 <= 2880,大于该值时会提示:单次请求超过限制
例如:请求2个域名, 请求时间为2天, 一天含288个数据点, 得到2*288*2 < 2880

输入参数

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

请求参数(GET)

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

参数名数据类型是否必须说明
domainsstring指定查询的加速域名,最多可一次性查询10个加速域名。
当查询多个加速域名时,返回多个加速域名的汇总数据。
传入all查询全部
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 , 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"
}

响应头部(Response Header)

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秒后重置当前粒度(分/小时/天)请求次数限制

http状态码说明

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