获取抽奖中奖名单 v1.0.0
| 拥有此API的权限集 |
|---|
| 直播管理-查询 |
请求方式及url
- 请求方式：
POST - 请求头：
Content-Type:application/json - 接口地址：
https://api.xiaoe-tech.com/xe.alive.marketing.winners_list_by_id/1.0.0 - 频率限制:
10秒50次
在线调试工具
请求
响应
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 专属token |
| alive_id | 是 | string | 直播 id |
| prize_id | 是 | string | 抽奖 id |
| page | 是 | int | 页码 min=1 |
| page_size | 是 | int | 每页条数 min=1,max=200 |
请求示例
{
"access_token": "xxxx",
"alive_id": "",
"prize_id":"prize_axxx",
"page":1,
"page_size":100
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码：0-成功，其他为错误 |
| msg | string | 对返回码的文本描述内容 |
| data | object | 返回数据 |
data 数据
| 参数名 | 类型 | 说明 |
|---|---|---|
| total | int | 总数 |
| list | object | 中奖用户列表 |
list 数据
| 参数名 | 类型 | 说明 |
|---|---|---|
| app_id | string | 店铺id |
| prize_id | string | 直播id |
| user_id | string | 用户ID |
| prize_product_id | string | 奖品id |
| winner_result_status | int | 1:未领奖 2:已领奖 3:奖品作废 4:领奖失败 |
| winner_result_msg | string | 领奖结果 |
| win_product_info | object | 奖品信息 |
win_product_info 数据
| 参数名 | 类型 | 说明 |
|---|---|---|
| prize_custom_title | string | 奖品名称 |
| prize_type | int | 奖品种类 1:自定义,2:资源产品,3:优惠券,4:优惠码,5:积分 |
| prize_value | string | 奖品 |
| prize_num | int | 奖品数量 |
返回示例
{
"code": 0,
"msg": "ok",
"data": {
"total": 1,
"list": [
{
"app_id": "appa1l6jbwk1476",
"prize_id": "prize_a47beba04400ce30sX95GvjneU",
"user_id": "u_6747ed472a369_70jLjNhDBz",
"prize_product_id": "prize_prd_RjHHpXdsQD09QypwWHSrmnqlas",
"winner_result_status": 2,
"winner_result_msg": "{\"code\":0,\"data\":{\"prize_id\":\"prize_a47beba04400ce30sX95GvjneU\",\"prize_type\":1},\"msg\":\"领取成功\"}",
"win_product_info": {
"prize_custom_title": "aa",
"prize_type": 1,
"prize_num": 1,
"prize_value": "{\"prize_title\":\"aaa\",\"prize_image\":{\"is_default\":\"1\",\"image\":\"https:\\/\\/commonresource-1252524126.cdn.xiaoeknow.com\\/image\\/lr4jie720frq.png\"},\"contact_information\":{\"is_wx_number\":\"1\",\"wx_number\":\"aaa\",\"is_qrcode\":\"0\",\"qrcode\":\"\"}}"
}
}
]
}
}