群组列表

接口说明

获取当前登录用户所在的全部群组，返回群组基本信息及未读消息数量。

请求信息

项目	内容
方法	GET
URL	https://devapi.fengshengshou.com/api/groups
鉴权	是，需在请求头携带 Token

请求参数

本接口无请求参数。

请求示例

curl -X GET "https://devapi.fengshengshou.com/api/groups" \
  -H "Authorization: Bearer your_token_here"

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	提示信息
data	array	群组列表，每项为一个群组对象
data[].id	int	群组 ID
data[].name	string	群组名称
data[].avatar	string|null	群组头像 URL，可为空
data[].description	string|null	群组描述，可为空
data[].member_count	int	当前成员数量
data[].owner_id	int	群主用户 ID
data[].owner_name	string|null	群主用户名，可为空
data[].role	string	当前用户在群中的角色
data[].conversation_id	int|null	关联会话 ID，可为空
data[].last_message	string|null	最后一条消息内容，可为空
data[].last_message_type	string|null	最后一条消息类型，可为空
data[].last_message_time	string|null	最后一条消息时间，可为空
data[].last_sender_name	string|null	最后发送者名称，可为空
data[].unread_count	int	未读消息数量

成功响应

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "id": 1,
      "name": "研发团队",
      "avatar": "https://devapi.fengshengshou.com/storage/avatars/group1.png",
      "description": "研发部门内部讨论群",
      "member_count": 12,
      "owner_id": 5,
      "owner_name": "张三",
      "role": "member",
      "conversation_id": 101,
      "last_message": "今天下午开会",
      "last_message_type": "text",
      "last_message_time": "2026-07-05 14:30:00",
      "last_sender_name": "李四",
      "unread_count": 3
    }
  ]
}

失败响应

{
  "code": 401,
  "message": "未授权，请先登录",
  "data": null
}