红包类
红包预领取
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_id | uint64_t | 是 | 来自收到红包的同一条消息,不能为 0 |
platform | const char * | 是 | 来自收到红包的同一条消息(PLATFORM_*) |
group_id | uint64_t | 是 | 群号(私聊传 0) |
user_id | uint64_t | 是 | 红包发送人 QQ 号,不能为 0 |
listid / authkey | const char * | 是 | 取自同一条 redpack 消息段 data 的同名非空字符串字段,原样传入,不得自行构造或混用 |
channel / pay_flag / hb_from | uint64_t | 是 | 取自同一条 redpack 消息段 data 的同名无符号整数字段,原样传入 |
返回值
返回完整 UTF-8 JSON 字符串(非 NULL 不代表业务成功,请检查其中的业务结果);NULL 表示接口不可用或请求失败(原因见日志)。框架会自动记录一条 [插件名] [pre_grab_red_packet] 完整 JSON 日志。用完必须调用 free_string() 交还。