English

get_group_system_msg

get_group_system_msg只读群信息

获取群系统消息

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

Parameters

Param	Type	Required	Default	Description
`group_id`	uint	–
`only_pending`	bool	–	`false`
`count`	int	–	`50`	每个收件箱最多读取的记录数

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	✓	群号
`group_name`	string	✓	群名称
`request_id`	integer	✓	请求序列号
`requester_uin`	integer	✓	申请人 QQ 号
`requester_nick`	string	✓	申请人昵称
`invitor_uin`	integer	✓	邀请人 QQ 号，无邀请时为 0
`invitor_nick`	string	✓	邀请人昵称
`message`	string	✓	验证留言
`checked`	boolean	✓	是否已处理
`flag`	string	✓	处理请求使用的规范 flag

Raw JSON Schema

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "group_id": {
        "type": "integer",
        "description": "群号"
      },
      "group_name": {
        "type": "string",
        "description": "群名称"
      },
      "request_id": {
        "type": "integer",
        "description": "请求序列号"
      },
      "requester_uin": {
        "type": "integer",
        "description": "申请人 QQ 号"
      },
      "requester_nick": {
        "type": "string",
        "description": "申请人昵称"
      },
      "invitor_uin": {
        "type": "integer",
        "description": "邀请人 QQ 号，无邀请时为 0"
      },
      "invitor_nick": {
        "type": "string",
        "description": "邀请人昵称"
      },
      "message": {
        "type": "string",
        "description": "验证留言"
      },
      "checked": {
        "type": "boolean",
        "description": "是否已处理"
      },
      "flag": {
        "type": "string",
        "description": "处理请求使用的规范 flag"
      }
    },
    "required": [
      "group_id",
      "group_name",
      "request_id",
      "requester_uin",
      "requester_nick",
      "invitor_uin",
      "invitor_nick",
      "message",
      "checked",
      "flag"
    ]
  }
}

Examples

curl

Python

JavaScript

SnowLuma SDK

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

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_system_msg#

Parameters#

Returns (data)#

Examples#

get_group_system_msg

Parameters

Returns (data)

Examples