MeBox/115doc/115开放平台/API列表/文件管理/回收站列表.md

回收站列表

基本信息

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

接口说明

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

接口地址

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

请求方式

GET

认证方式

Authorization: Bearer access_token

请求参数

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

请求示例

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 值，按文件类型返回

响应示例

{
  "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	补充单页记录数上限