接口描述:调用本接口查看预取任务
请求方式:get
请求路径:/preload-task/query-preload-task
使用说明: 单个用户一分钟限制调用10000次,并发不超过100
请求参数说明:
参数 | 类型 | 是否必填 | 名称 | 描述 |
---|---|---|---|---|
type | int | 否 | 查询方式 | 0(按照时间查询);1(按照submit_id查询);2(按照task_id查询)。默认为0 |
url | string | 否 | 模糊查询 | 比如url为“http://www.url.ctyun.cn/test/1.jpg”,那么入参url=http://www.url.ctyun或url=http://www.url.ctyun.cn/test都可查询到。需要保证url前面完整。 |
start_time | int | 否 | 开始时间戳 | 起始时间,时间戳(秒),type=0时,必填 |
end_time | int | 否 | 结束时间戳 | 结束时间,时间戳(秒),type=0时,必填 |
submit_id | string | 否 | 提交id | 预取提交id,type=1时,必填 |
task_id | string | 否 | 任务id | 预取任务id,type=2时,必填 |
page | int | 否 | 页数 | 默认1 |
page_size | int | 否 | 每页条数 | 默认50, 最大300 |
返回参数说明:
参数 | 类型 | 是否必填 | 名称及描述 |
---|---|---|---|
code | int | 是 | 状态码 |
message | string | 是 | 描述信息 |
total | int | 否 | 总条数 |
page | int | 否 | 页数 |
page_size | int | 否 | 本页条数 |
result | list< object> | 否 | 返回结果数组 |
result[*].url | string | 否 | 预取url |
result[*].submit_time | string | 否 | 提交时间 |
result[*].status | string | 否 | 任务执行状态:processing(进行中) completed(成功) failed(失败) |
result[*].headers | list< object> | 否 | 指定请求头,字段headers详细说明见下方 |
详细参数说明:
headers参数
参数 | 类型 | 是否必填 | 名称及描述 |
---|---|---|---|
name | string | 否 | 请求头名称,长度限制50个字符 |
value | string | 否 | 请求头值,长度限制100个字符 |
示例:
请求路径:https://cdnapi-global.ctapi.ctyun.cn/preload-task/query-preload-task
示例1:
请求:https://cdnapi-global.ctapi.ctyun.cn/preload-task/query-preload-task?type=0&start_time=1661500835&end_time=1664179235
返回结果:
{
"code": 100000,
"message": "success",
"total": 1,
"page": 1,
"page_size": 1,
"result": [
{
"submit_time": "2019-05-06 12:00:00",
"url": "http://www.test.ctyun.cn/test/",
"status": "completed",
"headers": [
{
"name": "test",
"value": "111"
},
{
"name": "test2",
"value": "222"
}
]
}
]
}
错误码请参考:参数code和message含义