- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- API参考
- 常见问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
查询异步任务详情
功能介绍
查询异步任务详情(该功能目前只有白名单用户使用)
URI
GET /koodrive/ose/v1/share/public/taskDetail
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
shareId |
是 |
String |
分享ID |
kdstoken |
否 |
String |
分享临时token |
taskId |
是 |
String |
任务id |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Traceid |
否 |
String |
业务跟踪id(必须58位) |
Authorization |
是 |
String |
该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} |
language |
否 |
String |
国际化语言标识,符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语,不传默认美式英语 |
X-User-Id |
是 |
String |
用户id,用于app鉴权 |
X-Date |
是 |
String |
日期,用于app鉴权 |
Host |
是 |
String |
地址,用于app鉴权 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
code |
Integer |
响应码 |
msg |
String |
响应信息 |
jobInfo |
JobInfo object |
工作信息 |
taskInfos |
TaskInfo object |
任务信息 |
参数 |
参数类型 |
描述 |
---|---|---|
userId |
String |
用户id |
taskId |
String |
任务id |
taskType |
Integer |
任务类型 |
taskStatus |
Integer |
任务状态,0:待处理,1:处理中,2:已完成,3:已取消 |
taskResultCode |
Integer |
任务处理结果,1:全部成功,2:部分失败,3:全部失败 |
createTime |
String |
任务创建时间,格式为14位时间戳yyyyMMddHHmmss |
startTime |
String |
任务开始时间,格式为14位时间戳yyyyMMddHHmmss |
endTime |
String |
任务结束时间,格式为14位时间戳yyyyMMddHHmmss |
progress |
Integer |
任务进度,进度百分比的值,如进度为70%时,返回的值是70 |
downloadUrl |
String |
压缩包下载链接 |
请求示例
/koodrive/ose/v1/share/public/taskDetail?kdstoken=561b**********01f11ee46f&shareId=15929***********1824&taskId=1593**********1056 Authorization:Bearer+10f88*************5a544791e9ff
响应示例
状态码: 200
OK
{ "jobInfo" : { "userId" : "2838*******************cd451", "taskId" : "159********61056", "taskType" : 1, "taskStatus" : 2, "taskResultCode" : 3, "resultCode" : 99, "createTime" : "2025******034", "startTime" : "2025******5034", "endTime" : "2025******5034", "progress" : 100 }, "taskInfos" : [ { "fileId" : "Fh0xWNbt************FrqSc5Cp", "status" : "2", "srcContainerId" : "IAAED************0415488", "resultCode" : "******", "resultDesc" : "*******" }, { "fileId" : "FnpODb******w-KX6fZi", "status" : "2", "srcContainerId" : "IAAEDBRX******24240415488", "resultCode" : "******", "resultDesc" : "******************" } ], "code" : 0, "msg" : "success" }
状态码
状态码 |
描述 |
---|---|
200 |
OK |