读取文件

读取文件消息中的资源，支持单段 Range 请求。请直接使用上传结果或消息中的完整 media.url。

GET /app/file/{year}/{month}/{key}/{file_name}

调用方： 资源访问或服务检查　·　认证： 无需用户凭证

不需要 IM Token。

请求参数

Path

参数	类型	必填	说明
year	string	是	资源 URL 中的四位年份，使用服务器给出的值。
month	string	是	资源 URL 中的两位月份，使用服务器给出的值。
key	string	是	服务器生成的资源标识，使用返回 URL 中的原值。
file_name	string	是	URL 编码后的文件名，使用返回 URL 中的原值。

Header

参数	类型	必填	说明
Range	string	否	可选单段字节范围，例如 bytes=0-1023、bytes=1024- 或 bytes=-1024。不支持一次请求多个范围。

请求示例

curl 'https://example.com/app/file/2026/10/ab590ea121b24453bf932153ad276ef5/outing-schedule.pdf' \
  --output outing-schedule.pdf

使用说明

• 完整内容为 HTTP 200，合法 Range 为 206，无效范围为 416，找不到资源为 404。
• 没有 code/msg/data JSON 包装。不要根据示例自行拼接资源地址，应使用服务器返回的完整 URL。
• 此地址不使用 IM Token，请只向有权访问内容的人分享文件 URL。

返回参数

此接口的成功响应是文件、图片或响应头，请按 HTTP 状态和响应头处理。

字段	类型	说明
Content-Type	header string	实际文件 MIME 类型。
Content-Length	header integer	当前响应内容的字节数；HEAD 为完整资源大小。
Content-Disposition	header string	inline，附带文件名及 UTF-8 编码文件名。
Cache-Control	header string	public, max-age=31536000, immutable，资源地址按不可变内容缓存。
X-Content-Type-Options	header string	nosniff，禁止浏览器猜测文件类型。
Content-Range	header string	仅部分内容或范围无效时返回。例如 bytes 0-1023/4096；416 时为 bytes */4096。

错误处理

HTTP 404 表示资源不可用；GET 文件请求的范围错误为 416。按本接口使用说明处理，不尝试解析通用 JSON。

返回上传与下载接口列表 · HTTP 请求约定