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

文件复制

基本信息

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

接口说明

将一个或多个文件、文件夹复制到指定目录。

接口地址

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

请求方式

POST
Content-Type: multipart/form-data

认证方式

Authorization: Bearer access_token

请求参数

参数名	类型	必填	默认值	说明	约束/示例
pid	string	否	"0"	目标目录ID，根目录ID为 0	1054251402869818368
file_id	string	是	-	待复制的文件或文件夹ID，多个ID使用半角逗号分隔	2323423573680609857
nodupli	int	否	0	目标目录是否不允许同名：0-允许，1-不允许	1

请求示例

curl 'https://proapi.115.com/open/ufile/copy' \
  -H 'Authorization: Bearer access_token' \
  --form-string 'pid=1054251402869818368' \
  --form-string 'file_id=2323423573680609857' \
  --form-string 'nodupli=1'

响应字段说明

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

响应示例

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

注意事项

• pid 不传或传 0 时复制到根目录。
• 接口受文件操作频率限制；触发限制时返回异常。
• user_id 由服务端根据 access token 获取，无需传入。

修改历史

修改时间	修改说明
2025年04月01日(周二) 00:00:00	创建文档