功能描述
用于获取照片/视频封面缩略图。
接口说明
视频封面使用该视频的首帧图片。
针对照片或视频封面,优先使用人脸识别智能缩放裁剪为
{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}
&history_id={HistoryId}
&purpose={Purpose}
&access_token={AccessToken}
&user_id={UserId}
请求参数:
LibraryId: 媒体库 ID,必选参数。
SpaceId: 空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(
-
);如果媒体库为多租户模式,则必须指定该参数;FilePath: 完整文件路径,例如
foo/bar/image.jpg
。Size: 缩放大小,可选参数,相关说明参阅接口说明。
Scale: 等比例缩放百分比,可选参数,不传 Size 时生效;
WidthSize: 缩放宽度,不传高度时,高度按等比例缩放,不传 Size 和 Scale 时生效。
HeightSize: 缩放高度,不传宽度时,宽度按等比例缩放,不传 Size 和 Scale 时生效。
FrameNumber: 帧数,针对 gif 的降帧处理。
HistoryId: 历史版本 ID,用于获取不同版本的文件内容,可选参数,不传默认为最新版。
Purpose: 用途,可选参数,列表页传 list、预览页传 preview(默认)。
AccessToken: 访问令牌,对于公有读媒体库或租户空间,可不指定该参数,否则必须指定该参数。
UserId: 用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参阅 生成访问令牌接口,可选参数。
请求体
该请求无请求体。
响应
响应码
获取成功,返回 HTTP 302 Found,响应头 Location 包含可直接用于展示或下载的文件 URL。
响应体
空,无响应体。