get_group_red_packets
获取指定群聊中当前仍可领取的红包。
此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。
适用协议
Android（手机 / 平板）；Linux QQ 支持情况待核验。
调用方式
Free 不可调用。Plus 每次调用核对当前 QQ 最新等级，至少需要 32 级；Pro 不设这项 QQ 等级门槛。红包列表属于领取材料，同样受此限制。
向已认证的 WebSocket 连接发送：
json
{
"type": "action",
"id": "example-1",
"action": "get_group_red_packets",
"params": {
"self_id": 123456789,
"protocol_id": 0,
"group_id": 987654321
}
}响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | integer | 是 | 当前框架内的账号 QQ 号 |
protocol_id | integer | 是 | 账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID |
group_id | integer | 是 | 目标群号 |
返回值
以下为成功响应的 data，错误通过 ok: false 与 error 返回。
| 字段 | 类型 | 说明 |
|---|---|---|
sender_id | integer | 发送者 QQ 号 |
title | string | 专属头衔 |
listid | string | 消息事件中的红包编号 |
authkey | string | 消息事件中的红包认证键 |
channel | integer | 上游红包通道值 |
pay_flag | integer | 消息事件中的红包支付标识 |
hb_from | integer | 消息事件中的红包来源标识 |
time | integer | 业务时间戳 |