智能媒资托管预览回收站项目

功能描述 
用于预览回收站项目。
说明：
可用于预览文档、图片、视频等多种文件类型；
预览文档类型的文件时，返回 HTML 或 JPG 格式的文档用于预览；
预览视频文件时，返回视频的首帧图片作为视频封面预览；
针对照片或视频封面，优先使用人脸识别智能缩放裁剪为 {Size}px × {Size}px 大小，如果未识别到人脸则居中缩放裁剪为 {Size}px × {Size}px 大小，如果未指定 {Size} 参数则使用照片或视频封面原图，最后 302 跳转到对应的图片的 URL；
可以直接在使用图片的参数中指定该 URL，例如小程序 <image> 标签、 HTML <img> 标签或小程序 wx.previewImage 接口等，该接口将自动 302 跳转到真实的图片 URL；
如果文件不属于可预览的文件类型，则会跳转至文件的下载链接；
请求
请求示例
GET /api/v1/recycled/{LibraryId}/{SpaceId}/{RecycledItemId}?preview&type={Type}&size={Size}&scale={Scale}&width_size={WidthSize}&height_size={HeightSize}&frame_number={FrameNumber}&access_token={AccessToken}
请求参数
请求参数
描述
类型
是否必选
LibraryId
媒体库 ID，在媒体托管控制台创建媒体库后获取，请参见 创建媒体库﻿
String
是
SpaceId
空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(`-`)；如果媒体库为多租户模式，则必须指定该参数，获取请参见 创建租户空间﻿
String
否
RecycledItemId
回收站项目 ID，获取请参见 列出回收站项目﻿
String
是
Type
文档类型文件的预览方式，如果设置为"pic"则以 JPG 格式预览文档首页，否则以 HTML 格式预览文档
String
否
Size
图片或视频封面的缩放大小，相关说明参阅接口说明
String
否
Scale
图片或视频封面的等比例缩放百分比，不传 Size 时生效
String
否
WidthSize
图片或视频封面的缩放宽度，不传高度时，高度按等比例缩放，不传 Size 和 Scale 时生效
String
否
HeightSize
图片或视频封面的缩放高度，不传宽度时，宽度按等比例缩放，不传 Size 和 Scale 时生效
String
否
FrameNumber
GIF 文件的帧数，针对 GIF 的降帧处理，仅在预览 GIF 类型文件时生效
String
否
AccessToken
访问令牌，对于公有读媒体库或租户空间，可不指定该参数，否则必须指定该参数获取请参见 生成访问令牌﻿
String
否
请求体
该请求无请求体。
响应
响应码
获取成功，返回 HTTP 302 Found，响应头 Location 包含可直接用于展示或下载的文件 URL。
响应体
该响应无响应体。
错误码
该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

请求参数	描述	类型	是否必选
LibraryId	媒体库 ID，在媒体托管控制台创建媒体库后获取，请参见创建媒体库	String	是
SpaceId	空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(`-`)；如果媒体库为多租户模式，则必须指定该参数，获取请参见创建租户空间	String	否
RecycledItemId	回收站项目 ID，获取请参见列出回收站项目	String	是
Type	文档类型文件的预览方式，如果设置为"pic"则以 JPG 格式预览文档首页，否则以 HTML 格式预览文档	String	否
Size	图片或视频封面的缩放大小，相关说明参阅接口说明	String	否
Scale	图片或视频封面的等比例缩放百分比，不传 Size 时生效	String	否
WidthSize	图片或视频封面的缩放宽度，不传高度时，高度按等比例缩放，不传 Size 和 Scale 时生效	String	否
HeightSize	图片或视频封面的缩放高度，不传宽度时，宽度按等比例缩放，不传 Size 和 Scale 时生效	String	否
FrameNumber	GIF 文件的帧数，针对 GIF 的降帧处理，仅在预览 GIF 类型文件时生效	String	否
AccessToken	访问令牌，对于公有读媒体库或租户空间，可不指定该参数，否则必须指定该参数获取请参见生成访问令牌	String	否

预览回收站项目

本页目录：

功能描述

请求

请求示例

请求参数

请求体

响应

响应码

响应体

错误码