Skip to content

获取抽奖中奖名单 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_tokenstring专属token
alive_idstring直播 id
prize_idstring抽奖 id
pageint页码 min=1
page_sizeint每页条数 min=1,max=200

请求示例

json
{
  "access_token": "xxxx",
  "alive_id": "",
  "prize_id":"prize_axxx",
  "page":1,
  "page_size":100
}

返回参数

参数名类型说明
codeint状态码:0-成功,其他为错误
msgstring对返回码的文本描述内容
dataobject返回数据

data 数据

参数名类型说明
totalint总数
listobject中奖用户列表

list 数据

参数名类型说明
app_idstring店铺id
prize_idstring直播id
user_idstring用户ID
prize_product_idstring奖品id
winner_result_statusint1:未领奖 2:已领奖 3:奖品作废 4:领奖失败
winner_result_msgstring领奖结果
win_product_infoobject奖品信息

win_product_info 数据

参数名类型说明
prize_custom_titlestring奖品名称
prize_typeint奖品种类 1:自定义,2:资源产品,3:优惠券,4:优惠码,5:积分
prize_valuestring奖品
prize_numint奖品数量

返回示例

{
    "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\":\"\"}}"
             }
          }
       ]
    }
}