超过1000种
营销玩法
产品中心 解决方案
活动营销中台 游戏化营销 积分运营 小程序运营 APP运营
用户案例 免费模板
10万
服务价格
  • 模板会员
    10万模板免费用
  • 企业会员
    更多高级功能满足企业需求
企业微信版
  • 登录
  • 立即注册
  • 优秀案例
  • 模板商店
  • 营销日历
  • 免费注册
人人秀帮助中心
搜索你的问题
新手入门
产品教程
帮助文档
商城运营
公众号
小程序
常见问题

指定用户中奖接口

接口功能说明

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

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


接口参数说明

请求地址

由第三方平台提供

请求方式

POST

参数名称

是否必须

说明

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"

}

 

相关文档

  • 返回API文档首页

  • 如何使用指定用户中奖

  • API接口规范及签名算法



  • 热门产品
    H5
    互动
    微商城
    小程序
    问卷
    积分商城
    海报
    公众号助手
    企微助手
    系统集成
    开放平台
  • 使用帮助
    帮助中心
    干货分享
    设计师入驻
    活动审核和关闭
    投诉举报
  • 联系我们
    关于人人秀
    用户协议
    更新日志
    商务合作 derekyue@rrx.cn
    在线客服 0551-65297210
  • 扫码关注我们
Copyright © 2014-2023 合肥星爵互动信息科技有限公司版权所有   皖ICP备14022481号 增值电信业务经营许可证:皖B2-20200055 备案皖公网安备 34010402701575号