## 文件移动

### 基本信息

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

### 请求示例

```shell
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  | 目标目录不在正常区域或已经删除     | 选择正常可用的目标目录       |

### 响应示例

```json
{
  "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   | 补充移动目标目录有效性约束及错误码     |