## 删除或清空回收站

### 基本信息

| 属性         | 内容                              |
|:-----------|:--------------------------------|
| 接口名称       | 删除或清空回收站                        |
| 接口版本       | 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 | 创建文档 |