内容设计
接口功能说明
该接口由第三方开发者提供给人人秀调用，适用于抽奖活动。
由第三方实现抽奖逻辑，判断用户是否具有抽奖权限，或者用于用户中什么奖品即指定用户中奖。
接口参数说明
请求地址 | 由第三方平台提供 | |
请求方式 | 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"
}
相关文档
