分片上传文件-上传分片

根据 预上传接口返回的上传事务 ID 和分片策略上传对应的文件分片。上传完成后，你需调用分片上传文件（完成上传）触发完成上传。了解完整的上传文件流程，参考分片上传文件概述。

使用限制

该接口不支持并发调用，且调用频率上限为 5 QPS，10000 次/天。否则会返回 1061045 错误码，可通过稍后重试解决。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/drive/v1/files/upload_part
HTTP Method	POST
接口频率限制	特殊频控
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	drive:drive 查看、评论、编辑和管理云空间中所有文件 drive:file 上传、下载文件到云空间 drive:file:upload 上传文件

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	示例值："multipart/form-data; boundary=---7MA4YWxkTrZu0gW"

请求体

名称	类型	必填	描述
upload_id	string	是	分片上传事务 ID。通过调用分片上传文件-预上传接口获取。 示例值："7111211691345512356"
seq	int	是	文件分片的序号，从 0 开始计数。 示例值：0
size	int	是	分片的大小，单位为字节。 示例值：4194304
checksum	string	否	文件分片的 Adler-32 校验和 示例值："3248270248"
file	file	是	文件分片的二进制内容 示例值：file binary

请求体示例

---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="upload_id";

7111211691345512356
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="seq";

0
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="size";

4194304
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="checksum";

3248270248
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file";
Content-Type: application/octet-stream

file binary
---7MA4YWxkTrZu0gW

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-

响应体示例

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

错误码

HTTP状态码	错误码	描述	排查建议
200	1061001	internal error.	服务内部错误，包括超时，错误码没处理。
400	1061002	params error.	请检查请求参数是否正确。
400	1061021	upload id expire.	上传事务 ID 过期，请重新调用预上传接口。
403	1061073	no scope auth.	没有申请接口权限。
400	1062007	upload user not match.	请确保当前请求身份和上传任务的身份为同一个。
400	1062008	checksum param Invalid.	请确保文件或文件分片的 checksum 正确。
400	1062009	the actual size is inconsistent with the parameter declaration size.	实际传输的文件大小和参数说明的大小不符合一致。
400	1062010	block missing, please upload all blocks.	部分文件分片缺失，请确保所有文件分片上传完成。
400	1062011	block num out of bounds.	上传过多文件分片，请确保上传的为对应文件。