帮助与文档

回源错误率 下载PDF文档

接口地址

请求URL: stat/originErrRatio (GET)

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

接口描述

用于查询加速域名的回源错误率数据。回源错误率是指:回源状态码4XX和5XX占总状态码的比例。

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

输入参数

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

请求参数(GET)

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

参数名数据类型是否必须说明
domainsstring指定查询的加速域名,最多可一次性查询1个加速域名。
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。
起始时间与结束时间间隔小于等于1天。
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。
起始时间与结束时间间隔小于等于1天。

调用示例

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

返回示例

json格式

正常示例
{
    "code": 0,//code为0,表示数据返回正常。
    "data": [
        [
            1590984900,//时间戳,按照升序排序。
            {
                "4xx": 0.0038,//4xx状态码的比例
                "5xx": 0 //5xx状态码的比例
            }
        ],
        [
            1590985200,
            {
                "4xx": 0.0032,
                "5xx": 0
            }
        ],
        [
            1590985500,
            {
                "4xx": 0.0033,
                "5xx": 0
            }
        ],
        ...
    ]
}

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

响应头部(Response Header)

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

http状态码说明

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