get_red_packet_info

查询群消息中 red_packet 消息段对应的 QQ 红包详细信息。

调用

const redPacket = event.message.find(segment => segment.type === 'red_packet')
const result = await api.get_red_packet_info(
  event.self_id,
  event.group_id,
  event.sender.user_id,
  redPacket.data,
)

也可以直接把完整的 red_packet 消息段作为第 4 个参数传入，官方 SDK 会自动读取其中的 data。

参数

参数	类型	必填	说明
`self_id`	number	是	在线 Bot QQ 号
`group_id`	number	是	红包所在群号
`sender_uin`	number	是	红包发送人 QQ 号
`red_packet`	object	是	收到的 `red_packet` 消息段 `data`
`red_packet.title`	string	否	红包标题
`red_packet.listid`	string	是	红包列表 ID
`red_packet.authkey`	string	是	红包鉴权串
`red_packet.channel`	number	否	红包渠道，缺省为 `0`
`red_packet.pay_flag`	number	是	红包支付标记，取自收到的 `red_packet` 消息段
`red_packet.hb_from`	number	是	红包来源标记，取自收到的 `red_packet` 消息段

原始 action 参数

未使用官方 SDK 时，red_packet 必须作为对象放在 params 内：

{
  "action": "get_red_packet_info",
  "params": {
    "self_id": 644691423,
    "group_id": 714169244,
    "sender_uin": 51974055,
    "red_packet": {
      "title": "恭喜发财",
      "listid": "10000448012608253500114336737900",
      "authkey": "45c7afde0cb06eed0198c763b46a580a",
      "channel": 1,
      "pay_flag": 0,
      "hb_from": 0
    }
  }
}

请直接使用收到的红包消息段数据，不要自行拆分或重新生成 listid、authkey。官方 SDK 会兼容尚未更新的框架版本。

返回值

返回 QQ 红包服务解密后的 JSON 对象，例如：

{
  retcode: '0',
  retmsg: 'ok',
  pre_grap_token: 'rand=...&sign=...&ts=...&ver=1',
  send_object: {
    channel: '1',
    recv_amount: '0',
    recv_num: '0',
    send_listid: '10000452012608021400100537757900',
    send_name: '示例用户',
    send_uin: '350873596',
    total_amount: '100',
    total_num: '1',
    wishing: '恭喜发财',
  },
  state: '16',
}

pre_grap_token 位于返回对象顶层。正式领取时，将它作为 grab_red_packet 的第 5 个参数传入。

get_red_packet_info

调用

参数

原始 action 参数

返回值

目录