优化，添加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,79 @@
+## 删除或清空回收站
+
+### 基本信息
+
+| 属性         | 内容                              |
+|:-----------|:--------------------------------|
+| 接口名称       | 删除或清空回收站                        |
+| 接口版本       | v1.0                            |
+| 接口路径       | /del                            |
+| 请求方法       | POST                            |
+| 接口状态       | 生产环境                            |
+
+### 接口说明
+
+批量彻底删除回收站中的文件(夹)，或在不传 `tid` 时清空回收站。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/rb/del
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名 | 类型     | 必填 | 默认值 | 说明                              | 约束/示例 |
+|:----|:-------|:---|:----|:--------------------------------|:------|
+| tid | string | 否  | ""  | 需要删除的回收站ID，多个ID用半角逗号分隔，最多 1150 个；不传时清空回收站 | 1,2,3,4 |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/rb/del' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'tid=1,2,3,4'
+```
+
+### 响应字段说明
+
+| 字段      | 类型       | 描述            |
+|:--------|:---------|:--------------|
+| state   | boolean  | 状态码，true 表示成功 |
+| message | string   | 错误信息          |
+| code    | int      | 错误码           |
+| data    | string[] | 响应数据          |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 注意事项
+
+- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。
+- 不传 `tid` 会清空当前授权用户的整个回收站，操作后无法恢复。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |