文件预热 下载PDF文档

接口地址

请求URL: cache/prefetch (POST)

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

接口描述

大文件预热, 提前把文件分发到CDN全国各区域的节点中, 防止大量回源导致短期内带宽压力过大.
注意：单用户每日预热仅限10000条，频率限制见响应（response header）
注意: 预热的任务记录仅保留一个月, 相关预热状态请在该时间内做好查询保存

输入参数

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

请求参数(POST)

参数支持 form-data、x-www-form-urlencoded、json 等格式

调用示例:

curl -X POST "https://cdn.api.baishan.com/v2/cache/prefetch?token=xxx"\
    -H "Content-Type: application/json"\
    -d '{"urls":["http://aa.qingcdn.com/resources/rewq/images/logo.png","http://aa.qingcdn.com/resources/fgsa/images/username-caret.png","http://bb.qingcdn.com/resources/fdsa/images/bsc-icons.png","http://cc.qingcdn.com/resources/rewq/images/body-bg.jpg"]}'

返回示例

json格式

{
    "code": 0, //code为0，表示数据返回正常，非0时则不正常
    "data": {
        "task_id": "30042313", //本次预热提交的任务id, 可根据此id查询本次预热的url的状态
        "count": 4, //本次成功提交预热的url数量
        
        //err_urls: 该字段信息返回时, 主要原因如下:
        //1. url格式不符合规则
        //2. url域名必须为该账号下的域名
        //3. 域名可能为挂起或删除状态
        "err_urls":["http://xxxx.com/xx","hdsres.."] 
    }
}

响应(Response Header)

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

http状态码说明