功能描述
用于获取照片/视频封面缩略图。
说明：
视频封面使用该视频的首帧图片。
针对照片或视频封面，优先使用人脸识别智能缩放裁剪为 {Size}px × {Size}px 大小，如果未识别到人脸则居中缩放裁剪为 {Size}px × {Size}px 大小，如果未指定 {Size} 参数则使用照片或视频封面原图，最后302跳转到对应的图片的 URL。
可以直接在使用图片的参数中指定该 URL，例如小程序 <image> 标签、 HTML <img> 标签或小程序 wx.previewImage 接口等，该接口将自动 302 跳转到真实的图片 URL。
如果文件不属于可预览的媒体类型，则会跳转至文件的下载链接。
请求
请求示例
GET /api/v1/file/`{LibraryId}`/`{SpaceId}`/`{FilePath}`?preview&size=`{Size}`&scale=`{Scale}`&width_size=`{WidthSize}`&height_size=`{HeightSize}`&frame_number=`{FrameNumber}`&access_token=`{AccessToken}`&user_id=`{UserId}`
请求参数
|
LibraryId | 媒体库 ID，在媒体托管控制台创建媒体库后获取，请参见 创建媒体库 | String | 是 |
SpaceId | 空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(`-`)；如果媒体库为多租户模式，则为具体 ID，获取请参见 创建租户空间 | String | 是 |
FilePath | 完整文件路径，例如 foo/bar/file.docx，获取请参见 查看文件详情 | String | 是 |
Size | 缩放大小 | String | 否 |
Scale | 等比例缩放百分比，不传 Size 时生效 | Int | 否 |
WidthSize | 缩放宽度，不传高度时，高度按等比例缩放，不传 Size 和 Scale 时生效 | Int | 否 |
HeightSize | 缩放高度，不传宽度时，宽度按等比例缩放，不传 Size 和 Scale 时生效 | Int | 否 |
FrameNumber | 帧数，针对 gif 的降帧处理 | Int | 否 |
AccessToken | 访问令牌，对于公有读媒体库或租户空间，可不指定该参数，否则必须指定该参数获取请参见 生成访问令牌 | String | 否 |
UserId | 用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份，详情请参见 生成访问令牌接口 | String | 否 |
请求体
该请求无请求体。
响应
响应码
获取成功，返回 HTTP 200 OK。
重定向，返回 HTTP 302 Found，响应头 Location 包含可直接用于展示或下载的文件 URL。
响应体
响应体返回文件内容。
错误码
该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。