接口描述:调用本接口封禁多个URL
请求方式:post
请求路径:/forbid-task/create-forbid-task
使用说明:
- 单个用户一分钟限制调用10000次,并发不超过100;
- 单次调用最多支持200条url
请求参数说明:
参数 | 类型 | 是否必传 | 名称 | 描述 |
---|---|---|---|---|
urls | list< string> | 是 | 封禁URL | 单次调用最多支持200条url |
forbid_type | int | 否 | 封禁类型 | 10(忽略 url 参数和协议) 12(按照完整的 url 进行全匹配) 13(cache key去除协议) 14(基于缓存封解禁,即与提交的url相同缓存的文件都封禁) 不填默认屏蔽类型为14 |
返回参数说明:
参数 | 类型 | 是否必传 | 名称及描述 |
---|---|---|---|
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含义