mirror of
https://github.com/truewhile/MeBox.git
synced 2026-09-28 03:06:38 +08:00
truewhile
85 lines
2.3 KiB
Markdown
85 lines
2.3 KiB
Markdown
## 文件复制
|
|
|
|
### 基本信息
|
|
|
|
| 属性 | 内容 |
|
|
|:-----------|:---------------------------------|
|
|
| 接口名称 | 文件复制 |
|
|
| 接口版本 | 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 | 创建文档 |
|