读取群组合头像

读取服务器生成的群组合头像，使用 Group.avatar 中的完整地址。

GET /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 'https://example.com/uploads/avatars/group/6284173029/1792301400.webp' \
  --output group-avatar.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 请求约定