mirror of
https://github.com/truewhile/MeBox.git
synced 2026-09-28 03:06:38 +08:00
truewhile
127 lines
4.5 KiB
Markdown
127 lines
4.5 KiB
Markdown
## 回收站列表
|
|
|
|
### 基本信息
|
|
|
|
| 属性 | 内容 |
|
|
|:-----------|:--------------------------------|
|
|
| 接口名称 | 回收站列表 |
|
|
| 接口版本 | 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 | 补充单页记录数上限 |
|