分片上传文件(完成上传)
POST
/open-apis/drive/v1/files/upload_finish
自建应用商店应用
该接口不支持太高的并发,且调用频率上限为5QPS
错误码
HTTP状态码 | 错误码 | 描述 | 排查建议 |
---|---|---|---|
200 | 1061001 | internal error. | 服务内部错误,包括超时,错误码没处理。 |
400 | 1061002 | params error. | 请检查请求参数是否正确。 |
404 | 1061003 | not found. | 请确认对应资源是否存在。 |
403 | 1061004 | forbidden. | 请确认当前身份是否有对应上传节点的的权限,如用户是否有上传到指定doc的编辑权限。 |
400 | 1061101 | file quota exceeded. | 租户容量超限,请确保租户有足够容量进行上传。 |
400 | 1061021 | upload id expire. | 上传事务过期,请重头开始上传。 |
500 | 1061022 | file version conflict. | 文件版本号冲突。 |
400 | 1061041 | parent node has been deleted. | 请确认上传点未被删除。 |
400 | 1061042 | parent node out of limit. | 在当前上传点上传过多素材,请更换上传点。 |
400 | 1061043 | file size beyond limit. | 请检查文件长度以避免超出限制。具体限制请参考 |
400 | 1061044 | parent node not exist. | 请确认上传点是否存在。 |
200 | 1061045 | can retry. | 内部可重试错误,请稍后重试。 |
400 | 1061061 | user quota exceeded. | 个人容量超限,请确保个人有足够容量进行上传。 |
403 | 1061073 | no scope auth. | 没有申请接口权限。 |
403 | 1061500 | mount node point kill | 挂载点不存在。 |
400 | 1062007 | upload user not match. | 请确保当前请求身份和上传任务的身份为同一个。 |
400 | 1062010 | block missing, please upload all blocks. | 部分文件分片缺失,请确保所有文件分片上传完成。 |
400 | 1062505 | parent node out of size. | 云空间单树大小超限制(40W限制 )。 |
400 | 1062506 | parent node out of depth. | 云空间目录深度超限制(15限制)。 |
400 | 1062507 | parent node out of sibling num. | 云空间目录下挂载数量超过限制(单层1500限制 )。 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.feishu.cn/open-apis/drive/v1/files/upload_finish' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"upload_id": "123456",
"block_num": 1
}'
响应示例响应示例
{
"code": 0,
"msg": "Success",
"data": {
"file_token": "boxcnrHpsg1QDqXAAAyachabcef"
}
}
请求参数
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
Content-Type
string
必需
默认值:
application/json; charset=utf-8
Body 参数application/json
返回响应
修改于 2023-01-13 06:18:47