mirror of
https://github.com/truewhile/MeBox.git
synced 2026-09-28 03:06:38 +08:00
truewhile
92 lines
3.1 KiB
Markdown
92 lines
3.1 KiB
Markdown
## 文件移动
|
||
|
||
### 基本信息
|
||
|
||
| 属性 | 内容 |
|
||
|:-----------|:---------------------------------|
|
||
| 接口名称 | 文件移动 |
|
||
| 接口版本 | 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 | 补充移动目标目录有效性约束及错误码 |
|