简要描述:

  • 抽奖-主播开奖前抽奖详情

访问权限

账号类型 是否有权限
主账号
子账号

接口URL:

http://api.zmengzhu.com/business/v1/prizes/getPrizeView

请求方式:

GET

返回结果格式:

JSON

参数:

参数名 是否必须 类型 默认值 说明
prize_id int 抽奖活动id

返回示例:

响应成功JSON示例:

// 示例
{
    "code": 200,
    "msg": "ok",
    "data": {
        "prize": { //抽奖活动信息
            "id": "26234",
            "name": "全面的直播抽奖",
            "describe": "全面的直播抽奖",
            "start_time": "1723873558",//开始时间
            "end_time": "1724601599", //结束时间时间
            "type": "2",  // 2主播开奖,3用户抽奖
            "join_num": "0", //参与人数
            "status": "1", //状态  0:未开始 1:抽奖中 3:抽奖结束
            "first_open_prize": "0", //首次开奖时间
            "created_at": "1723873777",//创建时间
            "updated_at": "1723873777", //最近修改时间
            "is_force_bind_phone": "1" // 是否强制绑定手机号 1是 0 否
        },
        "awards": [ //奖品信息
            {
                "id": "46453", //奖品id
                "prize_id": "26234",
                "name": "奖品1",
                "weight": "1",
                "quantity": "100",//奖品数量
                "remain_quantity": "100", //剩余数量
                "status": "1",//状态 1:奖项未领取完 2:奖项已被领取完
                "created_at": "1723873777",
                "updated_at": "1723884834",
                "probability": "0.000",
                "reserve_user_ids": [123123], //内定用户id
                "reserve_user_list": [ //内定用户列表
					{
						uid:123123,//uid
						status:0, // 状态 0:未领奖 1:已领奖'
						phone:"133****1111", //手机号
						nickname:"打不i",//昵称
					}
				],
                "winner_user_list": [//中奖用户列表
					{
						uid:123123,//uid
						avatar:"头像地址",
						nickname:"打不i",//昵称
					},
					{
						uid:123222123,//uid
						avatar:"头像地址22",
						nickname:"打不i2222",//昵称
					}
				]
            },
            {
                "id": "46454",
                "prize_id": "26234",
                "name": "奖品2",
                "type": "1",
                "weight": "2",
                "goods_image": "/upload/img/65/01/6501c8fb7cdc7dba1d17c27b947f8472.jpeg",
                "quantity": "200",
                "remain_quantity": "200",
                "status": "1",
                "created_at": "1723873777",
                "updated_at": "1723884834",
                "probability": "0.000",
                "reserve_user_ids": [],
                "reserve_user_list": [],
                "winner_user_list": []
            }
        ]
    }
}

错误时返回:

{
    "code": 20001,
    "msg": "签名校验失败",
    "data": {}
}