文档首页/ 云空间服务 KooDrive/ API参考/ API/ 分享管理-访问链接/ 创建分享异步任务 - createBatchTask
更新时间：2025-10-22 GMT+08:00
查看PDF
分享

创建分享异步任务 - 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位）

X-User-Id

是

String

用户id，用于app鉴权

X-Date

是

String

日期，用于app鉴权

Host

是

String

地址，用于app鉴权
表2 请求Body参数

参数

是否必选

参数类型

描述

taskType

是

Integer

批量操作任务类型；1：下载，2：转存

containerId

是

String

文件所在空间

fileIds

是

Array of strings

文件id列表

targetFileId

否

FileIdInfo object

目标目录信息，转存的时候不为空

zipName

否

String

压缩包名称，与文件管理的打包下载一致

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" : 0,
  "containerId" : "string",
  "fileIds" : [ "string" ],
  "targetFileId" : {
    "fileId" : "string",
    "containerId" : "string"
  },
  "zipName" : "string",
  "shareId" : "string",
  "kdstoken" : "string"
}

响应示例

状态码：200

OK

{
  "code" : "integer",
  "msg" : "string",
  "taskId" : "string"
}

状态码

状态码

描述

200

OK

相关文档