English

get_group_member_list

get_group_member_list只读群信息

获取群成员列表

Call via POST http://127.0.0.1:3000/get_group_member_list (JSON params as the body) or WebSocket.

Parameters

Param	Type	Required	Default	Description
`group_id`	uint	✓		群号
`no_cache`	bool	–	`false`

Returns (data)

群成员信息对象数组。

Every response is wrapped in the standard envelope: { "status": "ok", "retcode": 0, "data": ... }. The table below describes data.

data is an array; each element:

Field	Type	Required	Description
`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）

Raw 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"
    ]
  }
}

Examples

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}'

Using an AI assistant?

MCP-capable clients can discover and call this action directly — no hand-written HTTP. See MCP.

ON THIS PAGE

get_group_member_list#

Parameters#

Returns (data)#

Examples#

get_group_member_list

Parameters

Returns (data)

Examples