更新时间：2026-05-15 GMT+08:00
创建分享异步任务 - createBatchTask
功能介绍
创建分享异步任务。
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/share/tasks
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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鉴权 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| taskType | 是 | Integer | 批量操作任务类型；1：下载，2：转存 |
| containerId | 是 | String | 文件所在空间 |
| fileIds | 是 | Array of strings | 文件id列表 |
| targetFileId | 否 | FileIdInfo object | 目标目录信息，转存的时候不为空 |
| zipName | 否 | String | 压缩包名称，与文件管理的打包下载一致 |
| shareId | 是 | String | 分享id |
| kdstoken | 否 | String | 分享临时token |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 |
父主题： 分享管理-访问链接
