抽奖管理

事件编号: 3510

如未设置回调事件，请先创建回调事件才可以正常回调：回调事件创建

描述

抽奖管理已开启 , 新增、删除、修改抽奖时进行通知。

回调内容中的 user_id 与 child_user_id 为新增字段，新接客户默认存在，老客户如需请联系售后经理开通。

注意事项

当method_id=3510时，表示抽奖相关操作回调，具体行为由action字段区分：

action 值	说明	典型场景
base_info	抽奖基础信息	抽奖创建/修改时触发
condition_setting	抽奖条件设置	设置参与条件时触发
receive_setting	领取设置	配置奖品领取规则时触发
del	抽奖删除操作	删除活动下抽奖时触发

回调内容（base_info）

参数	类型	是否必须	说明
awardId	string	否	奖项ID（当前回调为空）
user_id	integer	是	用户ID
refer	string	是	来源标识，固定值"vhall"
signature	string	是	接口签名，用于验证请求合法性
method_id	integer	是	方法ID：3510-抽奖基础信息
webinar_id	integer	是	活动ID
child_user_id	integer	是	子账号ID（主账号操作时与user_id相同）
action	string	是	操作类型：base_info-基础信息
mid	string	是	消息唯一标识
time	integer	是	请求时间戳（秒级）
lotteryId	string	是	抽奖活动ID

回调内容（condition_setting）

参数	类型	是否必须	说明
`awardId`	string	否	奖项ID（当前为空）
`user_id`	integer	是	用户ID
`refer`	string	是	固定值 `"vhall"`
`signature`	string	是	签名校验值
`method_id`	integer	是	回调事件ID（3510-条件设置）
`webinar_id`	integer	是	活动ID
`child_user_id`	integer	是	子账号用户ID
`action`	string	是	操作类型（`condition_setting` 条件设置）
`mid`	string	是	消息唯一ID
`time`	integer	是	回调时间戳（秒级）
`lotteryId`	string	是	抽奖活动ID

回调内容（receive_setting）

参数	类型	是否必须	说明
`awardId`	string	否	奖项ID（当前为空）
`user_id`	integer	是	用户ID
`refer`	string	是	固定值"vhall"
`signature`	string	是	签名校验值
`method_id`	integer	是	回调事件ID（3510-领取设置）
`webinar_id`	integer	是	活动ID
`child_user_id`	integer	是	子账号用户ID
`action`	string	是	操作类型（receive_setting-领取设置）
`mid`	string	是	消息唯一ID
`time`	integer	是	回调时间戳（秒级）
`lotteryId`	string	是	抽奖活动ID

回调内容（del）

参数	类型	是否必须	说明
`awardId`	string	否	奖项ID（删除抽奖时为空）
`user_id`	integer	是	操作人用户ID
`refer`	string	是	固定值"vhall"
`signature`	string	是	接口签名(MD5)
`method_id`	integer	是	回调类型(3510-抽奖相关)
`webinar_id`	integer	是	关联活动ID
`child_user_id`	integer	是	子账号ID
`action`	string	是	操作类型(del-删除抽奖)
`mid`	string	是	消息唯一标识
`time`	integer	是	操作时间戳(秒级)
`lotteryId`	string	是	要删除的抽奖ID

回调示例

// 抽奖基础信息
{
    "awardId": "",
    "user_id": 72035607,
    "refer": "vhall",
    "signature": "9d5617e2efb49e9a2f801e5dad7e4a80",
    "method_id": 3510,
    "webinar_id": 949437269,
    "child_user_id": 72035607,
    "action": "base_info",
    "mid": "d9ecd2dabf4b7eb8b49ee2cd315a578d",
    "time": 1754891188,
    "lotteryId": "117364"
}

// 抽奖条件设置
{
    "awardId": "",
    "user_id": 72035607,
    "refer": "vhall",
    "signature": "e8ea42222ace436753130fa6e86e402f",
    "method_id": 3510,
    "webinar_id": 949437269,
    "child_user_id": 72035607,
    "action": "condition_setting",
    "mid": "33fd99691f4ea75ccc251086cdacba76",
    "time": 1754891279,
    "lotteryId": "117364"
}

// 领取设置
{
    "awardId": "",
    "user_id": 72035607,
    "refer": "vhall",
    "signature": "c0730e13d693ac6cd52f9ff0fb689051",
    "method_id": 3510,
    "webinar_id": 949437269,
    "child_user_id": 72035607,
    "action": "receive_setting",
    "mid": "6f1f108cd68fc222bfefbbf6da53410f",
    "time": 1754894727,
    "lotteryId": "117364"
}

// 抽奖删除操作
{
    "awardId": "",
    "user_id": 72035607,
    "refer": "vhall",
    "signature": "795ecbddff49dbf55bf7386c3d806e50",
    "method_id": 3510,
    "webinar_id": 949437269,
    "child_user_id": 72035607,
    "action": "del",
    "mid": "1d56eefb8923d1dd8faa931ffdd4a041",
    "time": 1754895501,
    "lotteryId": "117364"
}

描述#

注意事项#

回调内容（base_info）#

回调内容（condition_setting）#

回调内容（receive_setting）#

回调内容（del）#

回调示例#

描述

注意事项

回调内容（base_info）

回调内容（condition_setting）

回调内容（receive_setting）

回调内容（del）

回调示例