下载文件

最近更新时间:2025-10-24 15:25:21

我的收藏

功能描述

用于下载文件。
说明:
可以直接在使用文件的参数中指定该 URL,例如对于图片文件可直接在小程序 <image> 标签、 HTML <img> 标签或小程序 wx.previewImage 接口等中使用,该接口将自动302跳转到真实的图片 URL;视频和文件同理。

请求

请求示例

GET /api/v1/file/{LibraryId}/{SpaceId}/{FilePath}?history_id={HistoryId}&access_token={AccessToken}&user_id={UserId}

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
SpaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
FilePath
完整文件路径,例如 foo/bar/file.docx
String
HistoryId
历史版本 ID,用于获取不同版本的文件内容,不传默认为最新版,获取请参见 查看历史版本列表
String
AccessToken
访问令牌,获取请参见 生成访问令牌
String
UserId
用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参见 生成访问令牌接口
String

响应

响应码

获取成功,返回 HTTP 200 OK。

响应头部

响应参数
描述
类型
Location
包含可直接用于展示或下载的文件 URL
String
x-smh-type
媒体库类型
String
x-smh-creation-time
文件完成上传的时间
String
x-smh-content-type
文件类型
String
x-smh-size
文件大小
String
x-smh-etag
文件 etag
String
x-smh-crc64
文件的 CRC64-ECMA182校验值,为了避免数字精度问题,这里为字符串格式
String
x-smh-meta-*
自定义元数据
String

响应体

为文件内容

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。