## 回收站还原

### 基本信息

| 属性         | 内容                              |
|:-----------|:--------------------------------|
| 接口名称       | 回收站还原                           |
| 接口版本       | v1.0                            |
| 接口路径       | /revert                         |
| 请求方法       | POST                            |
| 接口状态       | 生产环境                            |

### 接口说明

批量还原回收站中的文件(夹)。

### 接口地址

```
https://proapi.115.com/open/rb/revert
```

### 请求方式

```
POST
Content-Type: multipart/form-data
```

### 认证方式

```
Authorization: Bearer access_token
```

### 请求参数

| 参数名 | 类型     | 必填 | 默认值 | 说明                         | 约束/示例         |
|:----|:-------|:---|:----|:---------------------------|:--------------|
| tid | string | 是  | -   | 需要还原的回收站ID，多个ID用半角逗号分隔，最多 1150 个 | 111,222,333,444 |

### 请求示例

```shell
curl 'https://proapi.115.com/open/rb/revert' \
  -H 'Authorization: Bearer access_token' \
  --form-string 'tid=111,222,333,444'
```

### 响应字段说明

| 字段      | 类型       | 描述            |
|:--------|:---------|:--------------|
| state   | boolean  | 状态码，true 表示成功 |
| message | string   | 错误信息          |
| code    | int      | 错误码           |
| data    | string[] | 响应数据          |

### 响应示例

```json
{
  "state": true,
  "message": "",
  "code": 0,
  "data": []
}
```

### 注意事项

- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。

### 修改历史

| 修改时间                         | 修改说明 |
|:-----------------------------|:-----|
| 2025年04月01日(周二) 00:00:00 | 创建文档 |