Skip to content

分片上传文件 - 上传分片

根据创建上传请求接口返回的上传请求 ID 和分片策略上传对应的文件分片。全部上传完成后可调用完成上传接口完成文件分片上传。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/spark/v1/apps/:app_id/storage/upload/part
HTTP MethodPOST
接口频率限制10 次/秒
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用spark:app.storage:write 获取与上传文件资源

请求头

名称类型必填描述
Authorizationstringuser_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring示例值:"multipart/form-data; boundary=---7MA4YWxkTrZu0gW"

路径参数

名称类型描述
app_idstring妙搭应用 id,可从妙搭应用 URL 中获取,如 https://miaoda.feishu.cn/app/app_4jcn5n11bpf5v 中的 app_4jcn5n11bpf5v 即为 app_id
示例值:"app_4jcn5n11bpf5v"

请求体

名称类型必填描述
upload_idstring上传请求 ID,可通过分片上传文件 - 创建上传请求获取。
示例值:"upload_abc123xyz456"
chunk_indexint分片编号从 1 开始
示例值:1
数据校验规则
- 取值范围:110000
filefile对应分片文件的二进制内容,不限制文件格式,需要与创建上传请求接口中的文件 MIME 类型一致。
示例值:file binary
chunk_check_sumstring对应分片文件的 md5
示例值:"ef176a6c424f954fa42d4cde03949897"

请求体示例

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

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

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


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

ef176a6c424f954fa42d4cde03949897
---7MA4YWxkTrZu0gW

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--

响应体示例

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

错误码

HTTP状态码错误码描述排查建议
4003340001param is invalid请检查请求参数的类型、格式或值是否符合接口要求,具体可参考请求参数说明中的数据校验规则。

内容来源:飞书开放平台 · 自动爬取整理