领取奖励回调
领取奖励回调
描述
回调内容中的
user_id 与 child_user_id 为新增字段，新接客户默认存在，老客户如需请联系售后经理开通。回调内容
| 参数名 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户ID |
| refer | string | 是 | 来源标识（固定值 "vhall" ） |
| signature | string | 是 | 签名校验值（MD5） |
| method_id | integer | 是 | 回调事件ID |
| webinar_id | string | 是 | 活动ID |
| child_user_id | string | 是 | 子账号用户ID（若活动属于主板号则与 user_id 相同） |
| mid | string | 是 | 消息id |
| time | integer | 是 | 当前 Unix 时间戳（秒级） |
| list | array | 是 | 奖励列表，单数 组元素为对象，详见下方 list 字段说明 |
奖励列表（list）
| 参数名 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| webinar_id | integer | 是 | 活动ID |
| reward_id | integer | 是 | 奖励ID |
| third_user_id | string | 否 | 第三方用户ID，可能为空 |
| user_email | string | 否 | 用户邮箱，可能为空 |
| award_snapshot | array | 是 | 奖品快照数组，用户领取的实际奖励 |
| received_at | string | 是 | 领取时间，格式：yyyy-MM-DD HH:mm:ss |
奖品快照（award_snapshot）
| 参数名 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| id | integer | 是 | 奖品快照内标识 |
| external_id | string | 否 | 三方奖品标识（接入方自定义） |
| title | string | 是 | 奖品标题 |
| type | string | 是 | 奖品类型 |
| remark | string | 否 | 奖品备注 |
回调示例
{
"user_id": 102852095,
"refer": "vhall",
"signature": "fe85b4ee7a864b8ecaf30db068cf0b08",
"method_id": 70,
"webinar_id": 256467889,
"child_user_id": 102852095,
"mid": "dd5658ed2e5147bc33a23211680feee3",
"time": 1744906079,
"list": [
{
"webinar_id": 421206776,
"reward_id": 329,
"third_user_id": "",
"user_email": "",
"award_snapshot": [
{
"id": 276,
"external_id": "测试三方奖品id000001",
"title": "测试奖品01",
"type": "类型1",
"remark": "备注1"
},
{
"id": 277,
"external_id": "测试三方奖品id000002",
"title": "测试奖品02",
"type": "类型2",
"remark": "备注2"
}
],
"received_at": "2025-04-17 23:23:51"
},
{
"webinar_id": 421206776,
"reward_id": 330,
"third_user_id": "",
"user_email": "",
"award_snapshot": [
{
"id": 276,
"external_id": "测试三方奖品id000001",
"title": "测试奖品01",
"type": "类型1",
"remark": "备注1"
},
{
"id": 278,
"external_id": "测试三方奖品id000003",
"title": "测试奖品03",
"type": "类型3",
"remark": "备注3"
}
],
"received_at": "2025-04-17 23:23:51"
}
]
}修改于 2025-08-07 19:08:15