上传文件

... 2026-2-4 小于 1 分钟

# 上传文件

# 接口说明

上传文件,文件会以原格式保留在云盘中,文件类型为 DRIVE

# 请求格式

描述 定义
Path /openapi/drive/v3/files:upload
Method POST
Content-Type multipart/form-data; boundary={calculated when request is sent}; charset=utf-8

# 请求头部

详见Headers

# 请求参数

# 请求体

参数名 类型 必选 描述
file HTTP FORM File 需要上传的源文件
folderId string 上传文件所在的目录

# 请求示例

curl --location 'https://{domain}/openapi/drive/v3/files:upload' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--form 'file=@"/Users/2408776.2408794.pdf"'
--form 'folderId="DGObYiFFCbjm"'
1
2
3
4
5
1
2
3
4
5

# 响应参数

# 响应体

参数名 类型 描述
taskId string 任务 Id,用于查询任务进度
type enum(TASK_TYPE) 任务类型,固定返回 UPLOAD

# 响应示例

{
    "taskId": "4652bcab5b3d42028f90677f11bd05df",
    "type": "UPLOAD"
}
1
2
3
4
1
2
3
4

# 错误码

查询通用错误码

上次编辑于: 2026年2月4日 15:01
贡献者: daleshen