读取群头像响应头

检查群组合头像的缓存信息，不下载图片。使用 Group.avatar 中的完整地址。

HEAD /uploads/avatars/group/{group_id}/{file}

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

不需要 IM Token。

请求参数

Path

参数	类型	必填	说明
group_id	string	是	公开群 ID，1–32 位字母、数字、点、下划线或连字符。
file	string	是	服务器返回的正整数版本号加 .webp，不自行计算版本。

Header

参数	类型	必填	说明
If-None-Match	string	否	上次响应的 ETag。未变化时服务器返回 304。

请求示例

curl -I 'https://example.com/uploads/avatars/group/6284173029/1792301400.webp'

使用说明

• HTTP 200 返回响应头，不返回图片正文。
• ETag 匹配时返回 304；资源不存在或版本无效时返回 404。此接口没有 code/msg/data JSON 包装。

返回参数

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

字段	类型	说明
Content-Type	header string	图片 MIME 类型。
Cache-Control	header string	该版本头像的缓存策略，以实际响应为准。
ETag	header string	当前内容版本，后续请求可放到 If-None-Match 中。
X-Content-Type-Options	header string	nosniff，禁止浏览器猜测文件类型。

错误处理

HTTP 404 表示资源不可用；缓存命中为 304。按本接口使用说明处理，不尝试解析通用 JSON。

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