English

get_group_member_info

get_group_member_info只读群信息

获取群成员信息

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

Parameters

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

Returns (data)

群成员信息对象。

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

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": "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_info \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"group_id":123456,"user_id":10001,"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_info#

Parameters#

Returns (data)#

Examples#

get_group_member_info

Parameters

Returns (data)

Examples