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

第三方奖品接口

接口功能说明

该接口用于发放第三方自有奖品体系,丰富奖品类型,打通用户系统中奖品领取。

该解决方案包含2个接口,《第三方奖品发放》接口用于对接第三方奖品,发放自有用户体系内的奖品、优惠劵等,可以同步发放到自有系统中比如APP、小程序等;《第三方奖品库》接口用于对接商家自有奖品体系,方便在人人秀平台快捷选择设置。


1.第三方奖品发放接口


开发注意:

  • 该接口由第三方开发者提供给人人秀调用,必须设置该接口地址

  • 开发者接收到参数,必须先将参数urldecode处理,然后计算签名

  • contacts 参数类型是json字符串,解析时需要注意转化成对象处理

请求地址

由第三方平台提供

请求方式

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

参数说明

参数名称

是否必须

说明

app_key

是

人人秀平台分配的AppKey

time_stamp

是

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

sign

是

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

openid

是

活动用户唯一标识

nickname

否

用户昵称

headimgurl

否

用户头像地址

order_no

是

人人秀订单号

prize_code

是

奖品标识码(用于开发者识别要发放的奖品)

phone

否

该字段提取contacts里的手机号,

只有在contacts里有手机号时才有值,方便开发者通过手机号发奖

contacts

否

该字段为用户信息。

该字段为JSON数组字符串

[{"id":"1","name":"姓名","value":"zcho"},

{"id":"3","name":"手机","value":"13635603333"}]

h5_guid否活动GUID

响应参数

参数

是否必须

参数说明

result

是

0:成功   1:失败

msg

否

result为1时,返回错误原因

data

否

result为0时,返回的第三方奖品展示信息

响应示例

成功

{"result":0,"msg":"","data":[{"name":"名称","value":"名称值"}],"link":{}}

失败

{"result":1,"msg":"没有领奖资格"}


data参数说明

参数是否必填参数说明
name

是

数组中一行的列名
value

是

数组中一行的列值


link参数说明

参数

是否必填项

参数说明
type

是

链接类型,1:普通链接;2:小程序链接;

当返回link参数后,领取奖品会直接跳转link链接,进入我的奖品可再次查看奖品详情

url

否

普通链接时必填,跳转的链接地址
username

否

小程序链接时必填,H5跳转小程序传原始ID  以 gh_开头;

原生小程序跳转传小程序appId

path

否

小程序链接时必填,需跳转的小程序页面路径 以 /xx开头

button_text

是

跳转链接按钮文案,当有link数据时,显示在奖品详情页面底部


对接步骤

第一步,对接收的参数进行urldecode处理

第二步,计算签名和验证签名

第三步,返回处理结果,返回值必须是json格式,即 Content-type: text/json


 

请求示例

{

    "app_key": "96c84928b1dce057d110ea3b3880fc83",

"time_stamp":"1543999047492",

"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",

"openid ": "gb_1543999047492",

"nickname": "小张子",

"headimgurl": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TMaE…zXTfZQugNBA/132",

"order_no": "1543999047492",

"prize_code": "zp_001",

"phone": "15811111111",

"h5_guid": "123456",

"contacts ": [

         {"id":101,"name":"姓名","value":"张三"},

         {"id":103,"name":"手机号","value":"15811111111"},

]

}

 

 

 

返回值示例,json格式 Content-type: application/json

{

    "result": 0,

"data": [

{"name": "劵号","value": "3932933"},

{"name": "使用说明","value": "到店请主动出示给店员"}

],

"link": {

"type": "1",

"url": "https://",

"button_text": "点击查看奖品"}

},

    "msg": "ok"

}



2.第三方奖品库接口


开发注意:

  • 该接口由第三方开发者提供给人人秀调用,设置后可用

  • 开发者接收到参数,必须先将参数urldecode处理,然后计算签名

请求地址

由第三方平台提供

请求方式

POST

参数名称

是否必须

说明

app_key

是

人人秀平台分配的AppKey

time_stamp

是

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

sign

是

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

 login_id

否

登录账号,查询指定账号数据。   查看子账号账号 

空则是主账号,查询主账号数据否则查询子账号对应数据

page

是

第几页数据

limit

是

每页多少条数据

返回JSON格式结果

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

参数名称

说明

result

0表示成功,1表示失败

msg

表示失败详细描述

data

成功时,返回奖品数据


data参数说明

参数名称

是否必须

说明

total

是

数据总笔数

rows

是

数据列表


rows参数说明

参数名称

是否必须

说明

prize_name

是

奖品名称

prize_code

是

奖品标识


对接步骤

第一步,对接收的参数进行urldecode处理

第二步,计算签名和验证签名

第三步,返回处理结果,返回值必须是json格式


 

请求示例

{

    "app_key": "96c84928b1dce057d110ea3b3880fc83",

"time_stamp":"1543999047492",

"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",

"login_id ":'''',

"page ":1,

"limit ":20

}

 

 

返回值示例,json格式 Content-type: application/json

{

    "result": 0,

"data": {

  "total": 1,

"rows":  [

{

"prize_name": "商品1",

"prize_code": "zp_001"

}

]

    },

    "msg": "ok"

}



相关文档

  • 返回API文档首页

  • API接口规范及签名算法

  • 如何使用第三方奖品

  • 如何开通API


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