编辑直播抽奖

拥有此API的权限集
直播管理-增删改

请求方式及url

• 请求方式：POST
• 请求头：Content-Type:application/json
• 接口地址：https://api.xiaoe-tech.com/xe.alive.marketing.prize.edit/1.0.0
• 频率限制：10秒3000次

接口调试

GETPOSTPUTDELETE

https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/

请求参数

响应结果

暂无响应数据

请求参数

参数名	必选	类型	说明
access_token	是	string	专属token
prize_id	是	string	抽奖ID
alive_id	是	string	直播ID
prize_name	是	string	抽奖名称
participant_condition. alive_id	是	string	直播ID
participant_condition. type	是	int	2-在线，3-任意评论，4-指定评论，5-分享直播间，6-使用积分，7-下单任意金额，8-下单指定商品，9-指定等级会员
participant_condition. is_show_participant	是	int	0-不展示参与任务，1-展示
participant_condition. ext.content	否	string	type对应的补充条件
bind_resources. resource_id	否	string	课程/商品: 资源ID
bind_resources. resource_type	否	int	课程/商品：资源类型
bind_resources. prize_custom_title	否	string	课程/商品：奖项名称
bind_resources. sort	否	int	课程/商品：序号
bind_resources. prize_num	否	int	课程/商品：奖品数量
bind_resources. prize_product_id	否	string	课程/商品：产品ID
bind_resources. sku_id	否	string	课程/商品：SKU
bind_promo_codes. batch_id	否	string	营销码券：批号ID
bind_promo_codes. resource_type	否	int	营销码券：资源类型
bind_promo_codes. prize_custom_title	否	string	营销码券：奖项名称
bind_promo_codes. sort	否	int	营销码券：序号
bind_promo_codes. prize_num	否	int	营销码券：奖品数量
bind_promo_codes. prize_product_id	否	string	营销码券：产品ID
bind_points. points	否	int	积分：积分数值
bind_points. prize_custom_title	否	string	积分：奖项名称
bind_points. sort	否	int	积分：序号
bind_points. prize_num	否	int	积分：奖品数量
bind_points. prize_product_id	否	string	积分：产品ID
bind_customs. prize_custom_title	否	string	自定义奖品：奖项名称
bind_customs. sort	否	int	自定义奖品：序号
bind_customs. prize_num	否	int	自定义奖品：奖品数量
bind_customs. prize_product_id	否	string	自定义奖品：产品ID
exclude_winners	是	int	是否可重复中奖 0-可重复中奖 1-不可重复中奖

请求示例

{
    "access_token":"xe_xxxxx",
    "prize_id": "prize_a51fef195800ed6sjVf8Isx8PV",
    "alive_id": "l_67da4e45e4b0694ca07ecc49",
    "prize_name": "测试抽奖",
    "participant_condition": {
        "alive_id": "l_67da4e45e4b0694ca07ecc49",
        "type": 2,   
        "is_show_participant": 0,
        "ext" : {"content" : ""} 
    },
    "bind_resources" : [
        {
            "resource_id" : "i_66b0770de4b0d84dbbf518a2",
            "resource_type" : 1,
            "prize_custom_title" : "三等奖-课程/商品",
            "sort" : 3,
            "prize_num" : 5,
            "prize_product_id" : "",
            "sku_id" : "SKU_ITX_7228408451510v6bav38"
        }
    ],
    "bind_promo_codes" : [
        {
            "batch_id" : "pc_mr382401_1b11QETuxUYs0HJSio1oPF",
            "resource_type" : 105,
            "prize_custom_title" : "二等奖-营销码券",
            "sort" : 3,
            "prize_num" : 5,
            "prize_product_id" : "prize_prd_3L0ZPjide1tD61BLceRX7OIjcB",
        }
    ],
    "bind_points": [
        {
            "points": 2,
            "prize_custom_title": "四等奖-积分",
            "sort": 4,
            "prize_num": 10,
            "prize_product_id": ""
        }
    ],
    "bind_customs": [
        {
            "prize_custom_title" : "一等奖-自定义",
            "sort": 1,
            "prize_num": 1,
            "prize_product_id": "prize_prd_UVX4vtqwRCVSRzjDkunjeMBmP9",
            "prize_value" : {
                "prize_title" : "自定义奖品",
                "prize_image" : {
                    "is_default" : 1,
                    "image" : "https://commonresource-1252524126.cdn.xiaoeknow.com/image/lr4jie720frq.png"
                }, 
                "contact_information" : {
                    "is_wx_number" : 1,
                    "wx_number" : "wx_123",
                    "is_qrcode" : 0,
                    "qrcode" : ""
                }
            }
        }
    ],
    "exclude_winners": 1 
}

返回参数

参数名	必选	类型	说明	备注
code	是	int	返回码	0-成功，其他失败
msg	是	string	返回信息	...
data	是	json对象	返回值	...
data.created_at	是	string	创建时间	2025-03-21 10:30:29
data.id	是	int	抽奖主键id	123
data.prize_count	是	int	奖品数量	18
data.prize_id	是	string	抽奖id	prize_a51fef195800ed6sjVf8Isx8PV
data.prize_name	是	string	抽奖名称	测试抽奖1
data.prize_product_list	是	json对象	设置的奖品	...

备注

• code=0时，msg:
• code!=0时，msg:创建直播任务失败

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "id": 1975339,
        "prize_id": "prize_a51fef195800ed6sjVf8Isx8PV",
        "prize_name": "测试抽奖1",
        "created_at": "2025-03-21 10:30:29",
        "prize_product_list": [
            {
                "app_id": "applccyjmr38240",
                "prize_id": "prize_a51fef195800ed6sjVf8Isx8PV",
                "prize_product_id": "prize_prd_3L0ZPjide1tD61BLceRX7OIjcB",
                "prize_custom_title": "二等奖-营销码券",
                "prize_type": 4,
                "resource_id": null,
                "resource_type": null,
                "prize_num": 3,
                "sku_id": null,
                "prize_value": "pc_mr382401_1b11QETuxUYs0HJSio1oPF",
                "sort": 1
            },
            {
                "app_id": "applccyjmr38240",
                "prize_id": "prize_a51fef195800ed6sjVf8Isx8PV",
                "prize_product_id": "prize_prd_j7fA124LEBJkB6ATXxDxGXs2Yn",
                "prize_custom_title": "三等奖-课程/商品",
                "prize_type": 2,
                "resource_id": "i_66b0770de4b0d84dbbf518a2",
                "resource_type": 1,
                "prize_num": 5,
                "sku_id": "SKU_ITX_7228408451510v6bav38",
                "prize_value": null,
                "sort": 2
            },
            {
                "app_id": "applccyjmr38240",
                "prize_id": "prize_a51fef195800ed6sjVf8Isx8PV",
                "prize_product_id": "prize_prd_c9ubIvEl7DMsO6jOYwSK0VEQqx",
                "prize_custom_title": "四等奖-积分",
                "prize_type": 5,
                "resource_id": null,
                "resource_type": null,
                "prize_num": 10,
                "sku_id": null,
                "prize_value": "1",
                "sort": 3
            }
        ],
        "prize_count": 18
    }
}