华为云用户手册

响应示例 状态码：200 全路径信息 { "fileIdPath" : "/DEUI7pa0C24ArootIAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4/FkbdCAceMj89bprz5xLJASID1eaRqjlRP/FqIAmBlIz7ovbThxeUBlOpbnCHaP_MTUL/FqS6hLLy_DkjlWdfOnEdCErhsmokRvdXI", "namePath" : "/rootIAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4/007/001/批量任务测试", "code" : 0, "msg" : "成功" }

响应示例 状态码：200 空间信息。 { "data" : { "tenantId" : "40086000004871666", "creator" : "369528171409614001", "createTime" : "2023-11-07T20:36:35.000Z", "modifier" : "369528171409614001", "updateTime" : "2023-12-26T11:40:07.000Z", "ownerId" : "369528171409614001", "type" : 1, "status" : 0, "capacity" : 800, "spaceUsed" : 91966408, "containerId" : "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4", "rootFileId" : "HFFdIb642fU51JWKAUlP6mwUVc8oDNKbO", "bizRootFileId" : "DEUI7pa0C24ArootIAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4", "bizSboxFileId" : "DEUI7pa0C24AsboxIAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4" }, "code" : 0, "msg" : "成功" }

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} X-Traceid 否 String 消息日志跟踪标识（必须58位） language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-User-Id 是 String 用户id，用于app鉴权 X-Date 是 String 日期，用于app鉴权 Host 是 String 地址，用于app鉴权

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 code Integer 响应码 msg String 响应消息 data SpaceInfo object 空间信息 表5 SpaceInfo 参数 参数类型 描述 type String 所有者类型 0：部门空间 1：个人空间 2：群组空间 status String 状态 ownerId String 云空间所有者 1、当为部门空间时，返回部门ID 2、当为个人空间时，返回用户ID 3、当为群组空间时，返回群组ID containerId String 云空间ID bizRootFileId String 业务根目录ID，存储未加密的普通文件 bizSboxFileId String 业务保险箱目录ID，存储加密的文件 capacity String 空间大小 spaceUsed String 已用空间大小 tenantId String 租户id creator String 创建者 createTime String 创建时间 modifier String 修改者id updateTime String 更新时间 rootFileId String 云空间根目录id

URI GET /koodrive/ose/v1/space/{owner_id} 表1 路径参数 参数 是否必选 参数类型 描述 owner_id 是 String 拥有者标识 表2 Query参数 参数 是否必选 参数类型 描述 type 是 String 空间类型 0：部门 1：个人 2：群组 containerId 否 String type=1且存在多个个人空间时需指定containerId

请求参数 表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参数 参数 是否必选 参数类型 描述 shareIds 否 Array of strings 取消分享ID列表，一次最多100

请求示例 POST /koodrive/ose/v1/share/tasks { "taskType" : 0, "containerId" : "string", "fileIds" : [ "string" ], "targetFileId" : { "fileId" : "string", "containerId" : "string" }, "zipName" : "string", "shareId" : "string", "kdstoken" : "string" }

请求参数 表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

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} X-Traceid 否 String 消息日志跟踪标识（必须58位） language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-User-Id 是 String 用户id，用于app鉴权 X-Date 是 String 日期，用于app鉴权 Host 是 String 地址，用于app鉴权 表2 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 空间名称 iconUrl 否 String 空间头像 capacity 否 Integer 空间大小 addGroupUsers 是 Array of AddGroupUsers objects 添加群组用户列表 表3 AddGroupUsers 参数 是否必选 参数类型 描述 userId 是 String 用户id template 是 Long 权限模板id，自定义模板传-1 capabilities 否 Capabilities object 权限值（自定义模板时传递） 表4 Capabilities 参数 是否必选 参数类型 描述 addChildNodePermission 是 Boolean 新建文件/文件夹权限；true有权限，false无权限。 copyPermission 是 Boolean 复制权限；true有权限，false无权限。 deletePermission 是 Boolean 删除权限；true有权限，false无权限。 downloadPermission 是 Boolean 下载权限；true有权限，false无权限。 editPermission 是 Boolean 编辑权限；true有权限，false无权限（暂不支持编辑）。 listChildNodePermission 是 Boolean 可见列表权限；true有权限，false无权限。 removeChildNodePermission 是 Boolean 移动权限；true有权限，false无权限。 renameFilePermission 是 Boolean 重命名权限；true有权限，false无权限。 shareFilePermission 是 Boolean 分享权限；true有权限，false无权限。 uploadPermission 是 Boolean 上传权限；true有权限，false无权限。 viewPermission 是 Boolean 预览权限；true有权限，false无权限。

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于批量文件处理接口，返回的消息体中部分内容如下所示。 { "data": "1309243162258308352" "code": 0, "msg": "success" } 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "code": 13000201, "msg": "inner server invoke failure" } 其中，code表示错误码，msg表示错误描述信息。

请求示例 将空间标识为IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4 空间下，文件id为FtSCRFXCYtFjo315lPfRHeKRiqrDdmm_Y的文件重命名为“下载”。 POST /koodrive/ose/v1/files/rename/FtSCRFXCYtFjo315lPfRHeKRiqrDdmm_Y Authorization:Bearer+10f88*********4791e9ff { "name": "下载", "containerId": "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4", "renameMode": 2 }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 status Integer 响应状态，0：全部成功，1：部分成功，2：全部失败 subResponseList Array of SubResponse objects 子响应列表 code String 响应码 msg String 响应信息 表5 SubResponse 参数 参数类型 描述 fileId String 文件id code String 响应码 message String 响应信息

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} X-Traceid 否 String 消息日志跟踪标识（必须58位） X-User-Id 是 String 用户id，用于app鉴权 X-Date 是 String 日期，用于app鉴权 Host 是 String 地址，用于app鉴权 表2 请求Body参数 参数 是否必选 参数类型 描述 starred 是 Boolean 是否收藏 subRequestList 是 Array of StarFileRequest objects 批量收藏文件列表 表3 StarFileRequest 参数 是否必选 参数类型 描述 containerId 是 String 空间id fileId 是 String 文件id，不允许重复

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 code String 响应码 msg String 响应信息 auditList Array of AuditData objects 审核结果 nextCursor String 分页游标，如果不存在，代表已返回最后一个 表4 AuditData 参数 参数类型 描述 sha256 String 文件sha256指纹 size Long 文件大小 auditResult Integer 文件审核结果 2：低敏文件 3：高敏文件 auditDetail String 审核结果详情 注：JSON字符串格式，仅支持存取 auditLevel Integer 审核级别 10：机审 20：人工审核 downloadUrl String 原文件下载链接

响应示例 状态码：200 审核列表查询响应 { "auditList": [ { "sha256": "d5757c6fe0882122d45456d1ecd2fbce59abfb00f86508be7f62304e7b0ec6d9", "size": 11239, "auditLevel": 10, "auditResult": 3, "auditDetail": "REJECT", "downloadUrl": "string", } ], "nextCursor": "MTcwODIzODc5MjAwMF9kNTc1N2M2ZmUwODgyMTIyZDQ1NDU2ZDFlY2QyZmJjZTU5YWJmYjAwZjg2NTA4YmU3ZjYyMzA0ZTdiMGVjNmQ5XzExMjM5", "code": 0, "msg": "success" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 格式“Bearer {app_access_token}”，需传入应用级token，用于应用服务端调用，通过创建应用时获得的clientid及clientSecret调用接口获取 2. 此处应用为KooDrive服务端 X-Traceid 否 String 消息日志跟踪标识（必须58位） language 否 String 国际化语言标识，符合i18n规范，如zh_cn表示简体中文，en_us表示美式英语 X-User-Id 是 String 用户id，用于app鉴权 X-Date 是 String 日期，用于app鉴权 Host 是 String 地址，用于app鉴权

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 code Integer 响应码 msg String 响应信息 data Array of PermissionTemplate objects 权限模板信息列表 表4 PermissionTemplate 参数 参数类型 描述 id String 权限模板的唯一id。 name String 权限模板的名称。 description String 权限模板的描述信息。 templateType Integer 权限模板的类型；0是预置模板，1是自定义模板。 status Integer 权限模板的状态；0是禁用，1是启用。 company String 权限模板归属的企业。可以是orgid，也可以是appid。 createTime String 权限模板的创建时间。 updateTime String 权限模板的更新时间。 capabilities Capabilities object 权限值。 表5 Capabilities 参数 参数类型 描述 addChildNodePermission Boolean 新建文件/文件夹权限；true有权限，false无权限。 copyPermission Boolean 复制权限；true有权限，false无权限。 deletePermission Boolean 删除权限；true有权限，false无权限。 downloadPermission Boolean 下载权限；true有权限，false无权限。 editPermission Boolean 编辑权限；true有权限，false无权限（暂不支持编辑）。 listChildNodePermission Boolean 可见列表权限；true有权限，false无权限。 removeChildNodePermission Boolean 移动权限；true有权限，false无权限。 renameFilePermission Boolean 重命名权限；true有权限，false无权限。 shareFilePermission Boolean 分享权限；true有权限，false无权限。 uploadPermission Boolean 上传权限；true有权限，false无权限。 viewPermission Boolean 预览权限；true有权限，false无权限。

响应示例 状态码：200 响应体 { "data" : [ { "id" : "******", "name" : "可见预览下载分享", "description" : "可见列表、预览、下载、分享", "templateType" : 1, "status" : 1, "company" : "*******", "createTime" : "2024-12-19T07:59:34.032Z", "updateTime" : "2024-12-19T07:59:57.786Z", "capabilities" : { "addChildNodePermission" : false, "copyPermission" : false, "deletePermission" : false, "downloadPermission" : true, "editPermission" : false, "listChildNodePermission" : true, "removeChildNodePermission" : false, "renameFilePermission" : false, "shareFilePermission" : true, "uploadPermission" : false, "viewPermission" : true } } ], "code" : 0, "msg" : "success" }

请求示例 /koodrive/ose/v1/audit/batch { "list" : [ { "sha256" : "6247ade6b2ef00bcd7ca618af137f8c0154395f4edc2b2f64566f7b676b33a10", "size" : 528263, "auditResult" : "3", "auditDetail" : "json", "fileId" : "string" } ] }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 格式“Bearer {app_access_token}”，需传入应用级token，用于应用服务端调用，通过创建应用时获得的clientid及clientSecret调用接口获取 2. 此处应用为KooDrive服务端 X-Traceid 否 String 消息日志跟踪标识（必须58位） language 否 String 国际化语言标识，符合i18n规范，如zh_cn表示简体中文，en_us表示美式英语 X-User-Id 是 String 用户id，用于app鉴权 X-Date 是 String 日期，用于app鉴权 Host 是 String 地址，用于app鉴权 表2 请求Body参数 参数 是否必选 参数类型 描述 list 是 Array of Audit objects 内容审核 记录列表 表3 Audit 参数 是否必选 参数类型 描述 sha256 是 String 文件sha256指纹 size 是 Long 文件大小 auditResult 是 Integer 文件审核结果 1：正常文件 2：低敏文件 3：高敏文件 auditDetail 否 String 审核结果详情 注：JSON字符串格式，仅支持存取 fileId 否 String 仅做日志记录，请求时包含，不做接口返回

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-Traceid 否 String 消息日志跟踪id(58位) X-User-Id 是 String 用户id，用于app鉴权 X-Date 是 String 日期，用于app鉴权 Host 是 String 地址，用于app鉴权

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 data UserImportResultDto object 用户批量导入结果 表4 UserImportResultDto 参数 参数类型 描述 successCount Integer 成功数量 failCount Integer 失败数量 failInfoList Array of UserImportFailInfo objects 用户批量导入失败信息 表5 UserImportFailInfo 参数 参数类型 描述 userName String 用户名 desc String 描述

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} X-Traceid 否 String 消息日志跟踪标识（必须58位） language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-User-Id 是 String 用户id，用于app鉴权 X-Date 是 String 日期，用于app鉴权 Host 是 String 地址，用于app鉴权 表3 请求Body参数 参数 是否必选 参数类型 描述 amendModRoles 是 Array of AmendModRole objects 需要更新用户权限信息 表4 AmendModRole 参数 是否必选 参数类型 描述 userId 是 Long 用户id template 是 Long 权限模板id，匿名模板传-1，（用户组批量添加成员或者用户组批量删除成员时非必填） capabilities 否 Capabilities object 权限值（自定义模板时传递） 表5 Capabilities 参数 是否必选 参数类型 描述 addChildNodePermission 是 Boolean 新建文件/文件夹权限；true有权限，false无权限。 copyPermission 是 Boolean 复制权限；true有权限，false无权限。 deletePermission 是 Boolean 删除权限；true有权限，false无权限。 downloadPermission 是 Boolean 下载权限；true有权限，false无权限。 editPermission 是 Boolean 编辑权限；true有权限，false无权限（暂不支持编辑）。 listChildNodePermission 是 Boolean 可见列表权限；true有权限，false无权限。 removeChildNodePermission 是 Boolean 移动权限；true有权限，false无权限。 renameFilePermission 是 Boolean 重命名权限；true有权限，false无权限。 shareFilePermission 是 Boolean 分享权限；true有权限，false无权限。 uploadPermission 是 Boolean 上传权限；true有权限，false无权限。 viewPermission 是 Boolean 预览权限；true有权限，false无权限。

请求示例 批量向群组369528171409614001添加用户。 POST /koodrive/ose/v1/usergroups/369528171409614001/members/batchAdd Authorization:Bearer+c69b0f40334782d560bb154032cf22ef43d671843c4ffbad { "userIds": ["3432423464657862424","132543141414141414"] }

请求示例 通过“分片上传”方式创建文件元数据，该示例指定了对应文件从46到50分片的分片，后续响应会返回对应分片的上传地址，需要将对应分片通过PUT请求上传对应的分片。 POST /koodrive/ose/v1/files/multipart/uploadUrl Authorization:Bearer+10f88*********4791e9ff { "fileId": "Fqo2kYHmsgWg5whxzYHZLL7mebXbBr1no", "multiParts": [ { "hashCtx": [ 1748048713, 2644528514, 4267727253, 2252747490, 4036182088, 2253856463, 526139147, 2194267752 ], "partNumber": 46, "partOffset": 471859200, "partSize": 10485760 }, { "hashCtx": [ 1606212, 1743131457, 2392241618, 605997363, 3054356113, 673008609, 3509469858, 2186398707 ], "partNumber": 47, "partOffset": 482344960, "partSize": 10485760 }, { "hashCtx": [ 3734586607, 1407828785, 3243195625, 3451635323, 4031416500, 3005674269, 2829389145, 3478923465 ], "partNumber": 48, "partOffset": 492830720, "partSize": 10485760 }, { "hashCtx": [ 3677016828, 906610338, 3389225168, 2507561547, 1134075905, 3951513567, 1673174790, 3034719756 ], "partNumber": 49, "partOffset": 503316480, "partSize": 10485760 }, { "hashCtx": [ 1827691250, 2956926651, 1801460777, 4119662276, 4162375117, 187866976, 1789369655, 278284511 ], "partNumber": 50, "partOffset": 513802240, "partSize": 10485760 } ] }

响应示例 状态码：200 对应分片的上传信息 { "multiParts" : [ { "partNumber" : 46, "partSize" : 10485760, "partOffset" : 471859200, "hashCtx" : [ 1748048713, 2644528514, 4267727253, 2252747490, 4036182088, 2253856463, 526139147, 2194267752 ], "uploadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/4e8108ee15fa471cbe5f18f03e8b555b086?partNumber=46&uploadId=0000019039E1E8520006EBE63B492EDB&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240621T082041Z&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240621%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Iteration-Hash-Ctx=eyJtZF9sZW4iOjMyLCJudW0iOjAsImgiOlsxNzQ4MDQ4NzEzLDI2NDQ1Mjg1MTQsNDI2NzcyNzI1MywyMjUyNzQ3NDkwLDQwMzYxODIwODgsMjI1Mzg1NjQ2Myw1MjYxMzkxNDcsMjE5NDI2Nzc1Ml0sIm5oIjowLCJubCI6Mzc3NDg3MzYwMCwiaGFzaF90eXBlIjoic2hhMjU2In0%3D&X-Amz-Signature=d3e7f60f45c8fd3960e697c57bb7d1c386dd20940b860fd976ba77425767d65e" }, { "partNumber" : 47, "partSize" : 10485760, "partOffset" : 482344960, "hashCtx" : [ 1606212, 1743131457, 2392241618, 605997363, 3054356113, 673008609, 3509469858, 2186398707 ], "uploadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/4e8108ee15fa471cbe5f18f03e8b555b086?partNumber=47&uploadId=0000019039E1E8520006EBE63B492EDB&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240621T082041Z&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240621%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Iteration-Hash-Ctx=eyJtZF9sZW4iOjMyLCJudW0iOjAsImgiOlsxNjA2MjEyLDE3NDMxMzE0NTcsMjM5MjI0MTYxOCw2MDU5OTczNjMsMzA1NDM1NjExMyw2NzMwMDg2MDksMzUwOTQ2OTg1OCwyMTg2Mzk4NzA3XSwibmgiOjAsIm5sIjozODU4NzU5NjgwLCJoYXNoX3R5cGUiOiJzaGEyNTYifQ%3D%3D&X-Amz-Signature=38980d3be00e528ee11c366ae69e950d673528203f3869a26f39dae42b4dabbb" }, { "partNumber" : 48, "partSize" : 10485760, "partOffset" : 492830720, "hashCtx" : [ 3734586607, 1407828785, 3243195625, 3451635323, 4031416500, 3005674269, 2829389145, 3478923465 ], "uploadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/4e8108ee15fa471cbe5f18f03e8b555b086?partNumber=48&uploadId=0000019039E1E8520006EBE63B492EDB&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240621T082041Z&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240621%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Iteration-Hash-Ctx=eyJtZF9sZW4iOjMyLCJudW0iOjAsImgiOlszNzM0NTg2NjA3LDE0MDc4Mjg3ODUsMzI0MzE5NTYyNSwzNDUxNjM1MzIzLDQwMzE0MTY1MDAsMzAwNTY3NDI2OSwyODI5Mzg5MTQ1LDM0Nzg5MjM0NjVdLCJuaCI6MCwibmwiOjM5NDI2NDU3NjAsImhhc2hfdHlwZSI6InNoYTI1NiJ9&X-Amz-Signature=d5608f38d6afdfee117be1243870b63f46ff11676633e0630d122f0c4145e8ae" }, { "partNumber" : 49, "partSize" : 10485760, "partOffset" : 503316480, "hashCtx" : [ 3677016828, 906610338, 3389225168, 2507561547, 1134075905, 3951513567, 1673174790, 3034719756 ], "uploadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/4e8108ee15fa471cbe5f18f03e8b555b086?partNumber=49&uploadId=0000019039E1E8520006EBE63B492EDB&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240621T082041Z&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240621%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Iteration-Hash-Ctx=eyJtZF9sZW4iOjMyLCJudW0iOjAsImgiOlszNjc3MDE2ODI4LDkwNjYxMDMzOCwzMzg5MjI1MTY4LDI1MDc1NjE1NDcsMTEzNDA3NTkwNSwzOTUxNTEzNTY3LDE2NzMxNzQ3OTAsMzAzNDcxOTc1Nl0sIm5oIjowLCJubCI6NDAyNjUzMTg0MCwiaGFzaF90eXBlIjoic2hhMjU2In0%3D&X-Amz-Signature=52eb71278fc9310f13a5b92641b5a726d0006be8dd89a242f9c4ce09c360e1f7" }, { "partNumber" : 50, "partSize" : 10485760, "partOffset" : 513802240, "hashCtx" : [ 1827691250, 2956926651, 1801460777, 4119662276, 4162375117, 187866976, 1789369655, 278284511 ], "uploadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/4e8108ee15fa471cbe5f18f03e8b555b086?partNumber=50&uploadId=0000019039E1E8520006EBE63B492EDB&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240621T082041Z&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240621%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Iteration-Hash-Ctx=eyJtZF9sZW4iOjMyLCJudW0iOjAsImgiOlsxODI3NjkxMjUwLDI5NTY5MjY2NTEsMTgwMTQ2MDc3Nyw0MTE5NjYyMjc2LDQxNjIzNzUxMTcsMTg3ODY2OTc2LDE3ODkzNjk2NTUsMjc4Mjg0NTExXSwibmgiOjAsIm5sIjo0MTEwNDE3OTIwLCJoYXNoX3R5cGUiOiJzaGEyNTYifQ%3D%3D&X-Amz-Signature=154bcd4ad7774f20e196666d403bf3d4359dd151b9cb1cc1f604c6517c4a287b" } ], "code" : 0, "msg" : "成功" }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-Traceid 否 String 消息日志跟踪标识（必须58位） X-User-Id 是 String 用户id，用于app鉴权 X-Date 是 String 日期，用于app鉴权 Host 是 String 地址，用于app鉴权 表2 请求Body参数 参数 是否必选 参数类型 描述 fileId 是 String 文件id multiParts 是 Array of MultiPartInfo objects 分片信息列表 表3 MultiPartInfo 参数 是否必选 参数类型 描述 partNumber 是 Integer 分片编号 partSize 是 Long 分片长度，取值范围[5242880, 5368709120]，最后一个分片取值范围[0, 5368709120] minimum: 0 maximum: 5368709120 partOffset 否 Long 到上一个数据块为止的总长度，单位为字节，该字段仅在分片并行上传时有效，分片并行上传时，除最后一个分片外，分片并行上传的其它分片大小，必须是 64字节的倍数 hashCtx 否 Array of longs 用于迭代计算SHA256的上下文，该字段仅在分片并行上传时有效。对于SHA1，取值为上一个数据块SHA1的第1-5个32位变量。对于SHA256，取值为上一个数据块SHA256的第1-8个32位变量。 注：分片并行上传时除第一个分片外其他分片必填。 uploadUrl 否 String 文件上传的URL，返回参数，上传文件需要使用PUT方法 partId 否 String 分片对象ID

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 multiParts Array of MultiPartInfo objects 分片信息 code Integer 响应码 msg String 响应消息 表5 MultiPartInfo 参数 参数类型 描述 partNumber Integer 分片编号 partSize Long 分片长度，取值范围[5242880, 5368709120]，最后一个分片取值范围[0, 5368709120] minimum: 0 maximum: 5368709120 partOffset Long 到上一个数据块为止的总长度，单位为字节，该字段仅在分片并行上传时有效，分片并行上传时，除最后一个分片外，分片并行上传的其它分片大小，必须是 64字节的倍数 hashCtx Array of longs 用于迭代计算SHA256的上下文，该字段仅在分片并行上传时有效。对于SHA1，取值为上一个数据块SHA1的第1-5个32位变量。对于SHA256，取值为上一个数据块SHA256的第1-8个32位变量。 注：分片并行上传时除第一个分片外其他分片必填。 uploadUrl String 文件上传的URL，返回参数，上传文件需要使用PUT方法 partId String 分片对象ID

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 fileId String 文件id rapidUpload Boolean 是否秒传命中（true表示秒传命中） containerId String 文件所在空间id fileName String 上传后文件名，如果没有重命名则和请求参数的文件名保持一致 uploadId String 文件上传Id parentFolder Array of strings 上传后文件所在父目录Id exist Boolean 文件是否存在，仅在入参autoRename=4时使用，当文件名一致，且文件的sha256一致，返回true multiParts Array of MultiPartInfo objects 分片信息，在分段上传时（uploadMode=multipart）返回 matchedPreHash Boolean 存在匹配的preHash code String 返回码 msg String 返回信息 表5 MultiPartInfo 参数 参数类型 描述 partNumber Integer 分片编号 partSize Long 分片长度，取值范围[5242880, 5368709120]，最后一个分片取值范围[0, 5368709120] minimum: 0 maximum: 5368709120 partOffset Long 到上一个数据块为止的总长度，单位为字节，该字段仅在分片并行上传时有效，分片并行上传时，除最后一个分片外，分片并行上传的其它分片大小，必须是 64字节的倍数 hashCtx Array of longs 用于迭代计算SHA256的上下文，该字段仅在分片并行上传时有效。对于SHA1，取值为上一个数据块SHA1的第1-5个32位变量。对于SHA256，取值为上一个数据块SHA256的第1-8个32位变量。 注：分片并行上传时除第一个分片外其他分片必填。 uploadUrl String 文件上传的URL，返回参数，上传文件需要使用PUT方法 partId String 分片对象ID

响应示例 状态码：200 上传文件第一步完成返回的信息 { "fileId" : "FnkL1QhXj8muHBuSWCHtFFY8Azue44Snr", "containerId" : "IAADfsBFCO6WtAtuA9add2fea594e4e75b8feb8474ef236", "fileName" : "test_20240104_105403.zip", "uploadId" : "0000018CD26464022026422966B8879A", "parentFolder" : [ "DEUI7pa0C24ArootIAADfsBFCO6WtAtuA9add2fea594e4e75b8feb8474ef236" ], "exist" : false, "multiParts" : [ { "partNumber" : 1, "partSize" : 22106481, "partOffset" : 0, "uploadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/ff6b221b4b474c829c1cd5037f1504ca086?partNumber=1&uploadId=0000018CD26464022026422966B8879A&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240104T025403Z&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240104%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Signature=39b9b620c8de901682675059cfcfa9902a13fb5c6ab38fe1451763feb6a8323c" } ], "code" : 0, "msg" : "Success." }