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

文件上传完成 - completeFile

功能介绍

当业务上传完文件的完整数据后,调用该接口。接口会对文件的完整性进行检查,检查通过则文件上传完成。数据文件需要加载到新加坡节点进行处理。

授权信息

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

URI

POST /koodrive/ose/v1/files/complete

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

language

String

参数解释:

国际化语言标识

约束限制:

符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语

取值范围:

不涉及

默认取值:

不传默认美式英语

Authorization

String

参数解释:

该字段存储的是Access Token。

调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。

约束限制:

格式参考:Bearer+{access_token}

取值范围:

Access Token的获取请参考对应的开发手册

默认取值:

不涉及

X-Traceid

String

参数解释:

消息日志跟踪标识(必须58位)

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-User-Id

String

参数解释:

koodrive侧用户id,用于app鉴权

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Date

String

参数解释:

日期,用于app鉴权

约束限制:

距当前时间15分钟以内,不能晚于当前时间

取值范围:

日期格式,yyyMMdd'T'HHmmss'Z',例:20251103T070140Z

默认取值:

不涉及

x-hw-share-folder-id

String

参数解释:

共享文件夹ID。如果传入了该请求头,则说明当前的操作是在共享文件夹内。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表2 请求Body参数

参数

是否必选

参数类型

描述

fileId

String

参数解释:

上传完成的文件id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

sha256

String

参数解释:

用SHA256计算的文件完整摘要信息

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

code

String

返回码

msg

String

返回消息

请求示例

当文件的二进制数据上传完毕后,调用该接口做分片合并以及完整性校验操作,文件上传完成。

POST /koodrive/ose/v1/files/complete

Authorization:Bearer+10f88*********4791e9ff

{
    "fileId": "FiqNTAYdzXtKhenh29A9EXJvhaKQqcYVS"
}

响应示例

状态码:200

上传完毕返回的信息

{
  "code" : 0,
  "msg" : "success."
}

状态码

状态码

描述

200

上传完毕返回的信息