接口描述:调用本接口创建预取任务。
请求方式:post
请求路径:/preload-task/create-preload-task
使用说明: 单个用户一分钟限制调用10000次,并发不超过100
请求参数说明:
参数 | 类型 | 是否必填 | 名称 | 描述 |
---|---|---|---|---|
values | list< string> | 是 | 预取文件列表 | 单次最多50条。若域名有做防盗链配置,则相应的预取url需同样带有防盗链。 |
headers | list< object> | 否 | 指定请求头 | 字段headers详细说明见下方 |
详细参数说明:
headers参数
参数 | 类型 | 是否必填 | 名称 | 描述 |
---|---|---|---|---|
name | string | 否 | 请求头名称 | 长度限制50个字符 |
value | string | 否 | 请求头值 | 长度限制100个字符 |
返回参数说明:
参数 | 类型 | 是否必传 | 名称及描述 |
---|---|---|---|
code | int | 是 | 状态码 |
message | string | 是 | 描述信息 |
submit_id | string | 否 | 预取提交id |
result | list | 否 | 创建的预取任务列表 |
result[*].url | string | 否 | 预取URL |
result[*].task_id | string | 否 | 预取任务id |
示例:
请求路径:https://cdnapi-global.ctapi.ctyun.cn/preload-task/create-preload-task
示例1:
请求参数:
{
"values": [
"http://xxx.ctyun.cn/xxx/xxx1.png",
"http://xxx.ctyun.cn/xxx/xxx2.png"
],
"headers": [
{
"name": "test",
"value": "111"
},
{
"name": "test2",
"value": "222"
}
]
}
返回结果:
{
"code": 100000,
"message": "success",
"submit_id": "cf48cdece3160f174a5f3026d52991ee",
"result": [
{
"task_id": "e12a05dc190045af2645f4b8bbe4135f",
"url": "http://xxx.ctyun.cn/xxx/xxx1.png"
},
{
"task_id": "e12a05dc190045af2645f4b8bbe4135f",
"url": "http://xxx.ctyun.cn/xxx/xxx2.png"
}
]
}
错误码请参考:参数code和message含义