跳转到正文
红包类

红包预领取

pre_grab_red_packet:仅查询红包状态和领取信息,不执行领取。

const char *pre_grab_red_packet(
    uint64_t self_id, const char *platform, uint64_t group_id, uint64_t user_id,
    const char *listid, const char *authkey,
    uint64_t channel, uint64_t pay_flag, uint64_t hb_from);
void free_string(const char *value);
  • 权限:pre_grab_red_packet
  • 调用要求:需要账号在线,请在工作线程中调用

参数

参数类型必填说明
self_iduint64_t是来自收到红包的同一条消息,不能为 0
platformconst char *是来自收到红包的同一条消息(PLATFORM_*)
group_iduint64_t是群号(私聊传 0)
user_iduint64_t是红包发送人 QQ 号,不能为 0
listid / authkeyconst char *是取自同一条 redpack 消息段 data 的同名非空字符串字段,原样传入,不得自行构造或混用
channel / pay_flag / hb_fromuint64_t是取自同一条 redpack 消息段 data 的同名无符号整数字段,原样传入

返回值

返回完整 UTF-8 JSON 字符串(非 NULL 不代表业务成功,请检查其中的业务结果);NULL 表示接口不可用或请求失败(原因见日志)。框架会自动记录一条 [插件名] [pre_grab_red_packet] 完整 JSON 日志。用完必须调用 free_string() 交还。

本页目录