保存或更新领奖页设置
POST
https://saas-open.vhall.com/v3/vss/api/lottery/save-receive-award-setting
领奖方式配置说明
字段定义
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
receive_award_way | integer | 是 | 领奖方式，可选值：1（寄送奖品）、2（私信兑奖）、3（无需领奖）、4（自定义领奖） |
data | string | 条件 | JSON字符串，根据receive_award_way的值传入不同结构 |
领奖方式详细规则
1. 寄送奖品（receive_award_way = 1）
data 格式要求：[
{
"is_system": 1,
"field": "姓名",
"field_key": "name",
"is_required": true,
"placeholder": "",
"rank": 1
},
{
"is_system": 1,
"field": "手机号",
"field_key": "phone",
"is_required": true,
"is_check": 1,
"placeholder": "",
"rank": 2
},
{
"is_system": 1,
"field": "联系地址",
"field_key": "address",
"is_required": false,
"placeholder": "",
"rank": 3
}
]2. 私信兑奖（receive_award_way = 2）
data 格式要求：[
{
"is_system": 1,
"field": "私信号码",
"field_key": "private_number",
"is_required": false,
"placeholder": "17545713516",
"rank": 1
},
{
"is_system": 1,
"field": "二维码",
"field_key": "private_qrcode",
"is_required": false,
"placeholder": "https://example.com/qrcode.jpg",
"rank": 2
},
{
"is_system": 1,
"field": "提示说明",
"field_key": "tip_note",
"is_required": true,
"placeholder": "请截图中奖页面添加客服领取奖品哦",
"rank": 3
}
]3. 无需领奖（receive_award_way = 3）
data 字段：4. 自定义领奖（receive_award_way = 4）
data 格式要求：[
{
"custom_btn_txt": "立即领奖",
"custom_link": "https://example.com/prize?lotteryId=123"
}
]请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://saas-open.vhall.com/v3/vss/api/lottery/save-receive-award-setting' \
--header 'platform;' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'webinar_id=509154312' \
--data-urlencode 'lottery_id=117230' \
--data-urlencode 'receive_award_way=4' \
--data-urlencode 'compulsory_award=0' \
--data-urlencode 'data=[{'\''custom_btn_txt'\'': '\''立即领奖'\'', '\''custom_link'\'': '\''https://e.vhall.com/v3/live/prizeSet/509154312?roomId=lss_1ae68ad9&index=second&lotteryId=117230'\''}]' \
--data-urlencode 'app_key=' \
--data-urlencode 'sign_type=' \
--data-urlencode 'signed_at=' \
--data-urlencode 'sign='响应示例响应示例
{
"code": 0,
"msg": "string",
"data": {}
}请求参数
Header 参数
Body 参数application/x-www-form-urlencoded
返回响应
修改于 2025-08-07 13:05:00