创建封禁任务
更新时间 2025-05-09 18:05:24
最近更新时间: 2025-05-09 18:05:24
接口描述:调用本接口封禁多个URL
请求方式:post
请求路径:/forbid-task/create-forbid-task
使用说明:
单个用户一分钟限制调用10000次,并发不超过100;
单次调用最多支持200条url;
封禁任务有效时长30天。
请求参数说明:
参数 | 类型 | 是否必传 | 名称 | 描述 |
---|---|---|---|---|
urls | list< string> | 是 | 封禁URL | 单次调用最多支持200条url |
forbid_type | int | 否 | 封禁类型 | 10(忽略 url 参数和协议); 12(按照完整的 url 进行全匹配); 13(cache key去除协议); 14(基于缓存封解禁,即与提交的url相同缓存的文件都封禁); 17(忽略协议); 18(忽略参数); |
返回参数说明:
参数 | 类型 | 是否必传 | 名称及描述 |
---|---|---|---|
code | int | 是 | 状态码 |
message | string | 是 | 描述信息 |
submit_id | string | 否 | 提交id |
result | list< object> | 否 | 封禁任务信息列表 |
result[*].url | string | 否 | 封禁的url |
result[*].task_id | string | 否 | 封禁任务的id |
result[*].forbid_type | int | 否 | 封禁类型 |
示例:
请求路径:https://cdnapi-global.ctapi.ctyun.cn/forbid-task/create-forbid-task
示例1:
请求参数:
{
"urls": [
"http://test.ctyun.cn/a/1.jpg",
"http://test.ctyun.cn/b/2.jpg"
]
}
返回结果:
{
"code": 100000,
"message": "success",
"submit_id": "5ac78cb5eb80dcd7cce90aff0a5a1588",
"result": [
{
"task_id": "0b1d927a2bffccc31aad6c24dd6099bc",
"forbid_type": 14,
"url": "http://test.ctyun.cn/a/1.jpg"
},
{
"task_id": "0b1d927a2bffccc31xxxxxxxxxxxxxxx",
"forbid_type": 14,
"url": "http://test.ctyun.cn/b/2.jpg"
}
]
}
错误码请参考:参数code和message含义