## 文件复制

### 基本信息

| 属性         | 内容                               |
|:-----------|:---------------------------------|
| 接口名称       | 文件复制                             |
| 接口版本       | 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                   |

### 请求示例

```shell
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[] | 响应数据                |

### 响应示例

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

### 注意事项

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

### 修改历史

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