上传文件

向云空间指定目录下上传一个小文件。

请不要使用这个接口上传大于20MB的文件，如果有这个需求可以尝试使用分片上传接口。

该接口支持调用频率上限为5QPS

错误码

HTTP状态码	错误码	描述	排查建议
200	1061001	internal error.	服务内部错误，包括超时，错误码没处理。
400	1061002	params error.	请检查请求参数是否正确。
404	1061003	not found.	请确认对应资源是否存在。
403	1061004	forbidden.	请确认当前身份是否有对应上传节点的的权限，如用户是否有上传到指定doc的编辑权限。
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	1061109	file name cqc not passed.	请确保上传的文件和文件名合规。
400	1061101	file quota exceeded.	租户容量超限，请确保租户有足够容量进行上传。
403	1061500	mount node point kill.	挂载点不存在。
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.	上传过多文件分片，请确保上传的为对应文件。
400	1061061	user quota exceeded.	个人容量超限，请确保个人有足够容量进行上传。
403	1061073	no scope auth.	没有申请接口权限。
200	1064230	locked for data migration	数据迁移中，暂时无法上传。
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限制）。

curl --location --request POST 'https://open.feishu.cn/open-apis/drive/v1/files/upload_all' \ --header 'Authorization;' \ --header 'Content-Type: multipart/form-data; boundary=---7MA4YWxkTrZu0gW' \ --form 'file_name="test.txt"' \ --form 'parent_type="explorer"' \ --form 'parent_node="fldcn77hdDT5"' \ --form 'size="1024"' \ --form 'file=@""'

请求参数

Header 参数

Content-Type

string

必需

示例值："multipart/form-data; boundary=---7MA4YWxkTrZu0gW"

示例值:

multipart/form-data; boundary=---7MA4YWxkTrZu0gW

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Body 参数multipart/form-data

file_name

必需

文件名示例值："test.txt" 数据校验规则：最大长度：250 字符

示例值:

test.txt

parent_type

必需

上传点类型示例值："explorer" 可选值有： explorer：云空间

示例值:

explorer

parent_node

必需

文件夹token，获取方式见概述 示例值："fldcn77hdDT5"

示例值:

fldcn77hdDT5

size

必需

文件大小,全量上传最大20M 示例值：1024 数据校验规则：最大值：20971520

示例值:

1024

checksum

可选

文件adler32校验和(可选) 示例值："123423882374238957235"

示例值:

123423882374238957235

file

必需

文件数据示例值：file binary

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

file_token

string

必需

新创建文件的 token

错误码#

请求参数

返回响应

错误码