第三方奖品接口

接口功能说明

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

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

1.第三方奖品发放接口

开发注意：

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

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

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

data参数说明

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处理，然后计算签名

data参数说明

rows参数说明

对接步骤

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

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

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

请求示例

{

    "app_key": "96c84928b1dce057d110ea3b3880fc83",

"time_stamp":"1543999047492",

"sign":"051BF3517D40AB9D7D6B45EF6E4EB7F9",

"login_id":'''',

"name":'抽纸''',

"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