还原回收站文件(夹)新版SDK
更新于 2024-01-11调用本接口还原回收站中的文件或文件夹。
为提升接口的使用体验,提供更加规范的接口,钉钉针对钉盘产品进行了升级,目前已升级为存储产品。本接口文档已于2023年01月17日迁移至历史文档(不推荐)目录下,且本接口仅保持现有功能,不再新增支持其他能力。
如果未使用本接口,推荐使用存储产品还原回收项接口。
如果已使用本接口,建议您根据自身实际情况切换至推荐接口。
调用本接口,实现还原回收站中的文件或文件夹,以还原回收站中的文件为例,具体示例如下图所示。

权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
企业内部应用 | 支持 | 重要 暂不支持新增申请。 | — |
第三方企业应用 | 支持 | 重要 暂不支持新增申请。 | — |
第三方个人应用 | 暂不支持 | — | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Body参数
名称 | 类型 | 是否必填 | 描述 |
recycleItemIdList | Array of Long | 是 | 回收站记录ID。
|
recycleType | String | 是 | 回收站类型。
|
unionId | String | 是 | 用户unionId。 |
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
400 | param.error | Invalid Param | 参数错误 |
400 | filename.invalid | File name error. | 文件名非法 |
400 | request.overlimit | You have sent too many requests. | 请求过于频繁 |
400 | unsupported.operation | Does not support the operation | 暂不支持该操作 |
400 | no.priviledge | You are not authorized to perform this operation. | 你没有权限进行此操作 |
404 | object.not.exist | File does not exist or has been deleted. | 文件不存在或已删除 |
500 | unknown.error | Unknown Error | 未知错误 |