帮助中心  /  指定用户中奖接口

指定用户中奖接口

接口功能说明

该接口由第三方开发者提供给人人秀调用,适用于抽奖活动。

由第三方实现抽奖逻辑,判断用户是否具有抽奖权限,或者用于用户中什么奖品即指定用户中奖。


接口参数说明

请求地址

由第三方平台提供

请求方式

POST方式,Content-type:application/x-www-form-urlencoded

参数名称

是否必须

说明

app_key

人人秀平台分配的AppKey

time_stamp

1970-01-01开始的时间戳,精确到毫秒

sign

根据签名算法所得,如何计算签名

activity_guid

活动guid,如何获取互动ID

h5_guid

H5活动guid

openid

用户的openid

contacts

当前用户报名填写的信息

[{"id":100,"title":"姓名","value":""},{"id":300,"title":"手机号","value":"15168372166"}]

activity_prize

当前活动的奖品列表,详情可查看活动奖品接口

[{"product_id":"18083","product_name":"商品1","product_type":"1","stock_qty":1}]

数据名称:奖品ID、奖品名称、奖品类型、奖品剩余数量

product_type枚举:1:实物;2:红包;5:优惠券;6:积分;7:自有奖品;8:礼品


返回JSON格式结果 Content-type: application/json

{"result":0,"msg":"","data":{}}

参数名称

说明

result

0表示成功,1表示失败

msg

表示失败详细描述

data

成功时,返回对应数据


data参数说明

参数名称

是否必须

说明

win_type

抽奖类型,1:指定用户中奖,2:人人秀系统抽奖

product_id

指定的奖品id (从接口返回的活动奖品列表中获取),当win_type=1时必填

product_id=0时,表示用户不中奖

 

请求示例

{

    "app_key""96c84928b1dce057d110ea3b3880fc83",

"time_stamp":"1543999047492",

"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",

"activity_guid ":"0e73db7048aadef7203831c904754dc9",

"h5_guid":"123456",

"openid":"gb_1543999047492",

"contacts":[

{

          "id":100,

"title":"姓名",

"value":"张三"

},

{

          "id":200,

"title":"手机号",

"value":"1581111111"

}

],

"activity_prize":[

{

          "product_id":10001,

"product_name":"商品1",

"product_type":"1",

"stock_qty":1

}

]

}


 

返回值必须是json格式 Content-type: application/json

{

    "result"0,

    "data": {

         "win_type""1",

         "product_id""10001",

    },

    "msg""ok"

}

 

相关文档