成员管理

获取成员列表

接口说明

获取指定群组的全部成员信息。

请求信息

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

请求参数

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

请求示例

curl -X GET "https://devapi.fengshengshou.com/api/groups/1/members" \
  -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[].nickname	string|null	用户在群内的昵称，可为空
data[].role	int	群内角色（群主 / 管理员 / 成员）
data[].joined_at	string|null	加入时间，格式 Y-m-d H:i:s，可为空

成功响应

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "id": 5,
      "name": "张三",
      "avatar": "https://devapi.fengshengshou.com/storage/avatars/5.png",
      "nickname": null,
      "role": 1,
      "joined_at": "2026-01-10 09:00:00"
    },
    {
      "id": 6,
      "name": "李四",
      "avatar": null,
      "nickname": "小李",
      "role": 3,
      "joined_at": "2026-01-11 10:30:00"
    }
  ]
}

失败响应

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

---

添加成员

接口说明

向指定群组添加新成员。仅群主或管理员可以执行此操作，被添加的用户 ID 须在系统中存在。

请求信息

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

请求参数

参数名	类型	必填	说明
id	int	是（路径参数）	群组 ID
user_ids	int[]	是	待添加用户的 ID 数组，所有 ID 须在系统中存在

请求示例

curl -X POST "https://devapi.fengshengshou.com/api/groups/1/members" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "user_ids": [7, 8]
  }'

响应参数

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

成功响应

{
  "code": 0,
  "message": "Members added",
  "data": null
}

失败响应

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

{
  "code": 403,
  "message": "没有权限添加成员",
  "data": null
}