查询异步任务详情 - getBatchTask
功能介绍
查询异步任务详情。
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/share/taskDetail
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Authorization | 是 | String | 参数解释: 该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
X-Traceid | 否 | String | 参数解释: 业务跟踪id(必须58位) 约束限制: 不涉及 取值范围: 长度为58位 默认值: 不涉及 |
X-User-Id | 是 | String | 参数解释: KooDrive侧用户id,用于app鉴权 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
X-Date | 是 | String | 参数解释: 日期,用于app鉴权,格式为yyyyMMdd‘T’HHmmss‘Z’ 约束限制: 距当前时间15分钟以内,不能晚于当前时间 取值范围: 不涉及 默认值: 不涉及 |
X-Hw-Agentname | 是 | String | 参数解释: 运营商名称 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
taskId | 是 | String | 参数解释: 创建异步分享返回的任务ID 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
shareId | 是 | String | 参数解释: 分享ID 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
kdstoken | 否 | String | 参数解释: 分享临时token 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
响应参数
状态码: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 | 压缩包下载链接 |
请求示例
POST /koodrive/ose/v1/share/taskDetail
{
"taskId" : "1689768877770401664",
"shareId" : "1689765568237837824",
"kdstoken" : "aea2968ec8cfac338cd4647f071c44644c491d0a2039cd6c"
} 响应示例
状态码:200
OK
{
"jobInfo" : {
"userId" : "1684711050387378049",
"taskId" : "1689768877770401664",
"taskType" : 1,
"taskStatus" : 2,
"taskResultCode" : 1,
"createTime" : "20250520022907",
"startTime" : "20250520022907",
"endTime" : "20250520022907",
"progress" : 100
},
"taskInfos" : [ {
"fileId" : "Fk63FCWhcDAga2puvYKRG1oTMjs-m30sI",
"status" : "1",
"newFileId" : "FpUqGxkEf54_NeuRnzRdGmrIrzQCPnKCP",
"srcContainerId" : "IAABh_RdhS8bOg0cA1684711052660690818"
} ],
"code" : 0,
"msg" : "Success."
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |

