简体中文

get_group_member_list

get_group_member_list只读群信息

获取群成员列表

通过 POST http://127.0.0.1:3000/get_group_member_list（请求体为 JSON 参数）或 WebSocket 调用。

输入参数

参数	类型	必填	默认	说明
`group_id`	uint	✓		群号
`no_cache`	bool	–	`false`

返回 (data)

群成员信息对象数组。

所有响应都包裹在标准信封中：{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。

data 为数组，每个元素：

字段	类型	必填	说明
`group_id`	integer	✓	群号
`user_id`	integer	✓	QQ 号
`nickname`	string	✓	昵称
`card`	string	–	群名片
`sex`	string (male / female / unknown)	–	性别
`age`	integer	–	年龄
`join_time`	integer	–	入群时间戳（秒）
`last_sent_time`	integer	–	最后发言时间戳（秒）
`level`	string	–	群等级
`role`	string (owner / admin / member)	✓	角色
`title`	string	–	专属头衔
`area`	string	–	地区（QQ NT 不提供，恒空）
`unfriendly`	boolean	–	是否不良记录（QQ NT 不提供，恒 false）
`title_expire_time`	integer	–	头衔过期时间戳（QQ NT 不提供，恒 0）
`card_changeable`	boolean	–	是否可改名片（占位，恒 true）

原始 JSON Schema

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "group_id": {
        "type": "integer",
        "description": "群号"
      },
      "user_id": {
        "type": "integer",
        "description": "QQ 号"
      },
      "nickname": {
        "type": "string",
        "description": "昵称"
      },
      "card": {
        "type": "string",
        "description": "群名片"
      },
      "sex": {
        "type": "string",
        "enum": [
          "male",
          "female",
          "unknown"
        ],
        "description": "性别"
      },
      "age": {
        "type": "integer",
        "description": "年龄"
      },
      "join_time": {
        "type": "integer",
        "description": "入群时间戳（秒）"
      },
      "last_sent_time": {
        "type": "integer",
        "description": "最后发言时间戳（秒）"
      },
      "level": {
        "type": "string",
        "description": "群等级"
      },
      "role": {
        "type": "string",
        "enum": [
          "owner",
          "admin",
          "member"
        ],
        "description": "角色"
      },
      "title": {
        "type": "string",
        "description": "专属头衔"
      },
      "area": {
        "type": "string",
        "description": "地区（QQ NT 不提供，恒空）"
      },
      "unfriendly": {
        "type": "boolean",
        "description": "是否不良记录（QQ NT 不提供，恒 false）"
      },
      "title_expire_time": {
        "type": "integer",
        "description": "头衔过期时间戳（QQ NT 不提供，恒 0）"
      },
      "card_changeable": {
        "type": "boolean",
        "description": "是否可改名片（占位，恒 true）"
      }
    },
    "required": [
      "group_id",
      "user_id",
      "nickname",
      "role"
    ]
  }
}

调用示例

curl

Python

JavaScript

SnowLuma SDK

curl -X POST http://127.0.0.1:3000/get_group_member_list \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"group_id":123456,"no_cache":false}'

在用 AI 助手？

支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。

ON THIS PAGE

get_group_member_list#

输入参数#

返回 (data)#

调用示例#

get_group_member_list

输入参数

返回 (data)

调用示例