优化，添加115接口文档

2026-10-14 00:56:37 +08:00 · 2026-09-05 14:32:58 +08:00
parent d00b14df55
commit 0e9fb2c937
57 changed files with 5682 additions and 76 deletions
@@ -0,0 +1,84 @@
+## 文件复制
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 文件复制                             |
+| 接口版本       | 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 | 创建文档 |