MeBox/115doc/115开放平台/API列表/文件管理/文件移动.md

文件移动

基本信息

属性	内容
接口名称	文件移动
接口版本	v1.0
接口路径	/move
请求方法	POST
接口状态	生产环境

接口说明

将一个或多个文件、文件夹移动到指定目录。

接口地址

https://proapi.115.com/open/ufile/move

请求方式

POST
Content-Type: multipart/form-data

认证方式

Authorization: Bearer access_token

请求参数

参数名	类型	必填	默认值	说明	约束/示例
file_ids	string	是	-	待移动的文件或文件夹ID，多个ID使用半角逗号分隔	3073323042143855813,3073323042143855822
to_cid	string	否	"0"	目标目录ID；0 表示根目录，非 0 时必须指向正常可用的目录	3073311192547189943

请求示例

curl 'https://proapi.115.com/open/ufile/move' \
  -H 'Authorization: Bearer access_token' \
  --form-string 'file_ids=3073323042143855813,3073323042143855822' \
  --form-string 'to_cid=3073311192547189943'

响应字段说明

字段	类型	描述
state	boolean	接口状态，true表示成功
message	string	异常信息
code	int	异常码
data	object[]	响应数据

响应的 code 字段(错误码)说明

错误码	说明	解决方案
20009	目标目录不存在或目标ID不是目录	确认 to_cid 指向存在的目录
20018	目标目录不在正常区域或已经删除	选择正常可用的目标目录

响应示例

{
  "state": true,
  "message": "",
  "code": 0,
  "data": []
}

注意事项

• to_cid 不传或传 0 时移动到根目录。
• to_cid 非 0 时，目标必须是正常可用的目录；目标不存在、不是目录或已经删除时，移动失败。
• 接口受文件操作频率限制；触发限制时返回异常。
• user_id 由服务端根据 access token 获取，无需传入。

修改历史

修改时间	修改说明
2025年04月01日(周二) 00:00:00	创建文档
2026年08月14日(周五) 15:38:44	补充移动目标目录有效性约束及错误码