保存或更新领奖页设置
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"
}
]请求参数
Header 参数
Body 参数application/x-www-form-urlencoded
请求示例代码
返回响应
修改于 2025-08-07 13:05:00