帮助与文档

日志下载 下载PDF文档

接口地址

请求URL: stat/log/getList (GET)

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

接口描述

获取指定域名的原始访问日志的下载地址。
注意:日志内容保留14天,请求频率限制见response header

输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,公有参数:用户的 token 可向值班同事获取

请求参数(GET)

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

参数名数据类型是否必须说明
domainstring单域名, 例如:aa.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为结束时间
with_typestring有直播日志可传入此参数进行查询(video_log), 例如with_type=video_log
need_md5int0(默认值):不返回MD5数据
1:日志下载数据附带上MD5信息
need_sizeint0(默认值):不返回size数据
1:日志下载数据附带上size信息

调用示例

curl -X GET "https://cdn.api.baishan.com/v2/stat/log/getList?token=xxx&start_time=2018-02-03&end_time=2018-02-03&domain=aa.qingcdn.com&need_md5=1&need_size=1"

返回示例

json格式

{
    "code": 0, //code为0,表示数据返回正常,非0时则不正常
    "data": [
        {
            "domain": "aa.qingcdn.com",
            "date": "2018-02-03 00:00",
            "type": "1",//1=一般日志, 2=直播日志
            "url": "http://xxxxx/cdnlog/aa.qingcdn.com/201802030000.gz?AWSAccessKeyId=v0l8ci2mrxowhnbz6e1q&Expires=1518197410&Signature=NvmPNmztJHO9C4ZIYZScH2wJO7s%3D"
            "md5": "12ee210scb41cfd6311ec22c2c9ssf64",
            "size": 4235  //一些情况获取不到日志的size时用"size": ""表示
        }
    ]
}

注意:域名没量时,返回数据为空
{
"code":0,
    "data":[]
}

响应(Response Header)

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

http状态码说明

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