读取文件响应头

读取文件的类型、大小等信息，不下载正文。请直接使用 media.url。

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

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

不需要 IM Token。

请求参数

Path

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

请求示例

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

使用说明

• 成功为 HTTP 200，不返回正文；找不到资源为 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，禁止浏览器猜测文件类型。

错误处理

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

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