更新时间:2026-02-03 GMT+08:00

创建分享异步任务 - createBatchTask

功能介绍

创建分享异步任务。

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/share/tasks

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

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

参数解释:

运营商名称

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

表2 请求Body参数

参数

是否必选

参数类型

描述

taskType

Integer

参数解释:

批量操作任务类型

约束限制:

不涉及

取值范围:

  • 1:打包下载

  • 2:转存

默认值:

不涉及

containerId

String

参数解释:

文件所在空间

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

fileIds

Array of strings

参数解释:

文件id列表

约束限制:

包含的文件ID数量最少1个,最多1000个

取值范围:

不涉及

默认值:

不涉及

targetFileId

FileIdInfo object

参数解释:

目标目录信息,当目标目录是根目录时,fileId应该传"root"

约束限制:

taskType=2时必填

取值范围:

不涉及

默认值:

不涉及

zipName

String

参数解释:

压缩包名称

约束限制:

taskType=1时必填

取值范围:

不涉及

默认值:

不涉及

shareId

String

参数解释:

分享id

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

kdstoken

String

参数解释:

分享临时token

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

表3 FileIdInfo

参数

是否必选

参数类型

描述

fileId

String

参数解释:

文件ID

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

containerId

String

参数解释:

空间ID

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应信息

taskId

String

任务id

请求示例

POST /koodrive/ose/v1/share/tasks

{
  "taskType" : 2,
  "containerId" : "IAABh_RdhS8bOg0cA1684711052660690818",
  "fileIds" : [ "Fk63FCWhcDAga2puvYKRG1oTMjs-m30sI" ],
  "shareId" : "1689765568237837824",
  "kdstoken" : "aea2968ec8cfac338cd4647f071c44644c491d0a2039cd6c",
  "targetFileId" : {
    "fileId" : "FhTB_fxx3LRszaivDFX9NN5JRNLnS9Gob",
    "containerId" : "IAABh_RdhS8bOg0cA1684711052660690818"
  }
}

响应示例

状态码:200

OK

{
  "code" : 0,
  "msg" : "Success",
  "taskId" : "1689765568237837824"
}

状态码

状态码

描述

200

OK