群组设置

获取群组详情

接口说明

获取指定群组的详细信息，包含群主信息及最近消息摘要。

请求信息

项目	内容
方法	GET
URL	/api/groups/{id}
鉴权	是，需在请求头携带 Token

请求参数

参数名	类型	必填	说明
id	int	是（路径参数）	群组 ID

请求示例

curl -X GET "/api/groups/1" \
  -H "Authorization: Bearer your_token_here"

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	提示信息
data.id	int	群组 ID
data.name	string	群组名称
data.avatar	string|null	群组头像 URL，可为空
data.description	string|null	群组描述，可为空
data.member_count	int	当前成员数量
data.max_member	int|null	最大成员数量限制，可为空
data.owner	object	群主信息
data.owner.id	int	群主用户 ID
data.owner.name	string	群主用户名
data.owner.avatar	string|null	群主头像 URL，可为空
data.conversation_id	int|null	关联会话 ID，可为空
data.last_message	string|null	最后一条消息内容，可为空
data.last_message_type	string|null	最后一条消息类型，可为空
data.last_sender_name	string|null	最后发送者名称，可为空
data.updated_at	string	最后更新时间，格式 Y-m-d H:i:s
data.created_at	string	创建时间，格式 Y-m-d H:i:s

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "id": 1,
    "name": "研发团队",
    "avatar": "https://devapi.fengshengshou.com/storage/avatars/group1.png",
    "description": "研发部门内部讨论群",
    "member_count": 12,
    "max_member": 100,
    "owner": {
      "id": 5,
      "name": "张三",
      "avatar": "https://devapi.fengshengshou.com/storage/avatars/5.png"
    },
    "conversation_id": 101,
    "last_message": "今天下午开会",
    "last_message_type": "text",
    "last_sender_name": "李四",
    "updated_at": "2026-07-05 14:30:00",
    "created_at": "2026-01-10 09:00:00"
  }
}

失败响应

{
  "code": 404,
  "message": "群组不存在",
  "data": null
}

---

修改群组信息

接口说明

修改指定群组的名称、描述或头像。仅群主或管理员可以执行此操作，所有字段均为可选，仅传入需要修改的字段即可。

请求信息

项目	内容
方法	PUT
URL	/api/groups/{id}
鉴权	是，需在请求头携带 Token

请求参数

参数名	类型	必填	说明
id	int	是（路径参数）	群组 ID
name	string	否	群组名称，最长 100 个字符
description	string	否	群组描述，最长 500 个字符
avatar	string	否	群组头像 URL 或路径，最长 255 个字符

请求示例

curl -X PUT "/api/groups/1" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "研发核心团队",
    "description": "研发部门核心成员讨论群"
  }'

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	提示信息
data	null	成功时为 null

成功响应

{
  "code": 0,
  "message": "Group updated",
  "data": null
}

失败响应

{
  "code": 404,
  "message": "群组不存在",
  "data": null
}

{
  "code": 403,
  "message": "没有权限修改群组信息",
  "data": null
}