缓存刷新 下载PDF文档

接口地址

请求URL: cache/refresh (POST)

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

接口描述

删除CDN全网节点上缓存的指定资源, 再次请求时会重新从源站获取指定资源并缓存.
注意：单用户每日刷新url数量最大10000, 每日刷新目录数量100, 全网生效时间为秒级生效, 频率限制见响应（response header）.
注意: 刷新的任务记录仅保留一个月, 相关刷新状态请在该时间内做好查询保存

输入参数

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

请求参数(POST)

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

调用示例:

curl -X POST "https://cdn.api.baishan.com/v2/cache/refresh?token=xxx"\
    -H "Content-Type: application/json"\
    -d '{"urls":["http:\/\/aa.qingcdn.com\/resources\/abc\/images\/logo.png","http:\/\/portal.qingcdn.com\/theme\/bsc1.7\/images\/username-caret.png","http:\/\/bb.qingcdn.com\/resources\/dfas\/images\/bsc-icons.png","http:\/\/bb.qingcdn.com\/resources\/rew\/images\/body-bg.jpg"],"type":"url"}'

返回示例

json格式

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

响应(Response Header)

HTTP/1.0 200 OK
Api-Id:                  70944777
Content-Type:            application/json; charset=utf-8
X-Ratelimit-Grad:      minute  //接口调用频率限制粒度(分/小时/天)
X-Ratelimit-Limit:     150  //当前每分钟请求次数上限
X-Ratelimit-Remaining: 99   //每分钟剩余请求次数
X-Retry-After:         14  //xx秒后重置当前粒度(分/小时/天)请求次数限制
X-Refresh-Url-Remaining: 9996 //当日url/dir推送剩余次数(推送url时是=X-Refresh-Url-Remaining, 推送目录时是: X-Refresh-Dir-Remaining)

http状态码说明