简体中文

get_group_system_msg

get_group_system_msg只读群信息

获取群系统消息

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

输入参数

参数	类型	必填	默认	说明
`group_id`	uint	–
`only_pending`	bool	–	`false`
`count`	int	–	`50`	每个收件箱最多读取的记录数

返回 (data)

群系统消息数组，可按群号或未处理状态过滤。

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

data 为数组，每个元素：

字段	类型	必填	说明
`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

原始 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"
    ]
  }
}

调用示例

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

在用 AI 助手？

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

ON THIS PAGE

get_group_system_msg#

输入参数#

返回 (data)#

调用示例#

get_group_system_msg

输入参数

返回 (data)

调用示例