请求URL: cache/purgeCheck (GET)
接口请求域名:
cdn.api.baishan.com
接口版本:v2
获取全网url资源校验结果
用于检验探测所有边缘节点上的相应资源是否不存在或者与源站一致，根据查询任务的batchId来获取回测结果
参数添加到在url的query部分，例如: ?key1=value1&key2=value2
| 参数名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|
| batchId | string | 是 | 通过提交查询任务接口获得的batchId来获取校验结果，只支持单个batchId |
curl -X GET 'https://api.qingcdn.com/v2/cache/purgeCheck?token=xxx&batchId=xxxxx'| 参数名 | 数据类型 | 说明 |
|---|---|---|
| code | int | 0：表示该批次存在文件缓存资源存在差异，详细见urlDetails 1：表示该批次所有的文件缓存资源一致 |
| status | int | 0：未开始，1：进行中，2：校验完成 |
| urlCount | int | 校验url总数 |
| urlSuccessCount | int | 校验完成的url数量 |
| urlDoingCount | int | 还未校验的url数量 |
| x-cnc-request-id | string | 日志id，如对此次请求有疑问，可提供此id给内部人员排查 |
| urlDetail | array | url详情 |
| --url | string | 校验url |
| --createTime | string | 创建时间 |
| --finishTime | string | 完成时间 |
| --sourceMd5Value | string | 源站MD5值 |
| --cachedMd5Value | array | 边缘节点上的md5值 |
| --sourceContentLength | int | 资源内容长度 |
| --requestCode | int | 下载资源时的状态码正常为200，404表示资源回源站，或者在边缘节点处获取不到。 |
| --header | string | url请求头 |
| --src | string | 回源地址 |
| --port | int | 回源端口 |
| --scheme | 回源协议 | https/http |
| --host | string | 默认url截取 |
json格式
{
"code": 0,
"data": {
"code": 1,
"status": 2,
"urlCount": 1,
"urlSuccessCount": 1,
"urlDoingCount": 0,
"x-cnc-request-id": "83c586be-5e1d-11f0-a268-fa163e6a239c",
"urlDetail": [
{
"url": "https://www.a.com/s/wl/config/domainCfg/prod.json",
"createTime": "2025-07-09T23:54:10+08:00",
"finishTime": "2025-07-09T23:59:28+08:00",
"sourceMd5Value": "da5017bac8704b0956e632b310d6f389",
"cachedMd5Value": [
"da5017bac8704b0956e632b310d6f389"
],
"sourceContentLength": 9615,
"requestCode": 200,
"header": "",
"src": "127.0.0.1",
"port": 443,
"scheme": "https",
"host": "www.a.com"
}
]
}
}HTTP/1.0 200 OK
Api-Id: 14426827
Content-Type: application/json; charset=utf-8
X-Ratelimit-Grad: minute //接口调用频率限制粒度(分/小时/天)
X-Ratelimit-Limit: 150 //当前每分钟请求次数上限
X-Ratelimit-Remaining: 10 //每分钟剩余请求次数
X-Retry-After: 20 //xx秒后重置当前粒度(分/小时/天)请求次数限制| 错误状态码 | 说明 |
|---|---|
| 404 | 您输入的 URL 错误 |
| 401 | 鉴权错误，您的token错误，或者没有开通接口权限 |
| 400 | 请求参数有误 |
| 200 | 执行成功，返回请求的数据 |
| 5xx | 请联系值班同事 |
