有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

功能描述

用于恢复指定回收站项目。

接口说明

要求权限:
非 acl 鉴权:admin、space_admin 或 restore_recycled
acl 鉴权:admin、space_admin
说明
非 acl 鉴权是指当前用户对所有文件的操作权限,详情可参考 生成访问令牌接口
acl 鉴权是通过共享授权接口给指定用户,以文件夹为单位授予的权限,详情可参考 角色授权模块
恢复项目时需保证该项目所在的目录存在。

请求

请求示例

POST /api/v1/recycled/{LibraryId}/{SpaceId}/{RecycledItemId}?restore&conflict_resolution_strategy={ConflictResolutionStrategy}&access_token={AccessToken}&user_id={UserId}
请求参数:
LibraryId:媒体库 ID,必选参数。
SpaceId:空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(-);如果媒体库为多租户模式,则必须指定该参数。
RecycledItemId:回收站项目 ID,必选参数。
ConflictResolutionStrategy:路径冲突时的处理方式。
ask:冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码。
rename:冲突时自动重命名文件。
overwrite:如果冲突目标为目录时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码,否则覆盖已有文件,可选参数,默认为 ask。
AccessToken:访问令牌,必选参数。
UserId:用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参阅 生成访问令牌接口,可选参数。

请求体

该请求无请求体。

响应

响应码

恢复成功,返回 HTTP 200 OK。

响应体

application/json
响应体示例:
{ "path": [ "foo", "bar", "file (1).docx" ] }
响应体字段说明: path:字符串数组,表示最终的文件路径。