帮助与文档

请求数查询 下载PDF文档

接口地址

请求URL: stat/request (GET)

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

接口描述

在此输入接口的作用
注意:

输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。

请求参数(GET)

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

参数名数据类型是否必须说明
domainsstring默认:all;
all返回用户下所有域名的总带宽, 可传入多个, 以英文逗号(,)分隔,单次不超过10个, 例如:aa.qingcdn.com,bb.qingcdn.com
start_timestring起始时间, 格式(YYYY-mm-dd和YYYY-mm-dd HH:ii)
参数传入2017-04-26时,代以 2017-04-26 00:00:00为起始时间
end_timestring结束时间, 格式(YYYY-mm-dd和YYYY-mm-dd HH:ii)
参数传入2017-04-26,代表以 2017-04-26 23:59:59为结束时间 ,
结束时间需大于起始时间,最大时间跨度为31天
gradstringminute5(默认值): 数据粒度, minute=1分钟,minute5=5分钟, hour=小时, day=天
domain_typestring域名类型,可传入多个, 以英文逗号(,)分隔;
默认所有;
范围【
网页:page;
下载:download;
点播:video_demand;
动态:dynamic;
上传:upload;
全站:total_station;
全协议:wpa;

调用示例:

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

返回示例:

JSON格式

{
    "code": 0,
    "data": [
        [
            1628438400,
            2312
        ],
        [
            1628438700,
            1907
        ]
    ]
}

响应(Response Header)

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

http状态码说明

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