## 回收站列表

### 基本信息

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

### 接口说明

分页获取当前授权用户的回收站文件(夹)列表。

### 接口地址

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

### 请求方式

```
GET
```

### 认证方式

```
Authorization: Bearer access_token
```

### 请求参数

| 参数名    | 类型  | 必填 | 默认值 | 说明      | 约束/示例 |
|:-------|:----|:---|:----|:--------|:------|
| limit  | int | 否  | 30  | 单页记录数   | 最大 200 |
| offset | int | 否  | 0   | 数据显示偏移量 | 0     |

### 请求示例

```shell
curl -G 'https://proapi.115.com/open/rb/list' \
  -H 'Authorization: Bearer access_token' \
  --data-urlencode 'limit=30' \
  --data-urlencode 'offset=0'
```

### 响应字段说明

| 字段                    | 类型      | 描述                             |
|:----------------------|:--------|:-------------------------------|
| state                 | boolean | 状态码，true 表示成功                  |
| message               | string  | 错误信息                           |
| code                  | int     | 错误码                            |
| data                  | object  | 响应数据                           |
| data.offset           | int     | 数据显示偏移量                        |
| data.limit            | int     | 单页记录数                          |
| data.count            | string  | 回收站文件(夹)总数                     |
| data.rb_pass          | int     | 是否设置回收站密码：1-是，0-否              |
| data.{回收站ID}          | object  | 以回收站ID为键的文件(夹)信息                |
| data.{回收站ID}.id       | string  | 回收站ID                          |
| data.{回收站ID}.file_name | string  | 文件(夹)名称                        |
| data.{回收站ID}.type     | string  | 类型：1-文件，2-文件夹                  |
| data.{回收站ID}.file_size | string  | 文件大小，单位为字节                     |
| data.{回收站ID}.dtime    | string  | 删除时间                           |
| data.{回收站ID}.thumb_url | string  | 缩略图地址                          |
| data.{回收站ID}.status   | string  | 还原状态：-1-还原中，0-正常                |
| data.{回收站ID}.cid      | int     | 原文件(夹)的父目录ID                   |
| data.{回收站ID}.parent_name | string  | 原文件(夹)的父目录名称                   |
| data.{回收站ID}.pick_code | string  | 文件提取码                          |
| data.{回收站ID}.isv      | int     | 是否为视频文件，按文件类型返回               |
| data.{回收站ID}.def2     | int     | 视频清晰度，按文件类型返回                 |
| data.{回收站ID}.ico      | string  | 文件扩展名，按文件类型返回                 |
| data.{回收站ID}.muc      | string  | 音频封面地址，按文件类型返回                |
| data.{回收站ID}.d_img    | string  | 文档缩略图地址，按文件类型返回               |
| data.{回收站ID}.play_long | int     | 音视频时长，按文件类型返回                 |
| data.{回收站ID}.sha1     | string  | 文件 SHA1 值，按文件类型返回              |

### 响应示例

```json
{
  "state": true,
  "message": "",
  "code": 0,
  "data": {
    "offset": 0,
    "limit": 30,
    "count": "0",
    "rb_pass": 0,
    "3074054555277845747": {
      "id": "3074054555277845747",
      "file_name": "",
      "type": "1",
      "file_size": "0",
      "dtime": "",
      "thumb_url": "",
      "status": "0",
      "cid": 0,
      "parent_name": "",
      "pick_code": "",
      "isv": 0,
      "def2": 0,
      "ico": "",
      "muc": "",
      "d_img": "",
      "play_long": 0,
      "sha1": ""
    }
  }
}
```

### 注意事项

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

### 修改历史

| 修改时间                         | 修改说明 |
|:-----------------------------|:-----|
| 2025年04月01日(周二) 00:00:00 | 创建文档 |
| 2026年08月05日(周三) 17:15:28 | 补充单页记录数上限 |