
该接口用于第三方自有核销平台,完成核销人人秀平台奖品。
开发注意:
该接口由人人秀提供给第三方开发者调用,第三方开发者调用该接口完成核销
每次请用都需要重新生成签名,否则会提示签名过期
请求地址 | https://open.rrx.cn/api/v1/thirdVerification/verify | |
请求方式 | POST 方式 Content-type:application/x-www-form-urlencoded | |
参数说明 | ||
参数名称 | 是否必须 | 说明 |
app_key | 是 | 人人秀平台分配的AppKey |
time_stamp | 是 | 1970-01-01开始的时间戳,精确到毫秒 |
sign | 是 | 根据签名算法计算所得,如何计算签名 |
verify_code | 是 | 奖品核销码 |
account_id | 否 | 人人秀子账号核销,登录账号 不传,则使用主账号权限核销 |
verify_loginid | 否 | 指定人人秀核销员核销,登录账号 (不支持纯数字)有值则优先使用 当传入新的verify_loginid时,表示创建新核销员,会消耗购买的核销员数量 |
| nick_name | 否 | 核销员昵称(当新创建核销员时必传) |
| mall_guid | 否 | 多品牌客户时 创建客户下子账号,需指定所属客户(可在独立管理后台获得对应客户GUID) |
| memo | 否 | 核销备注 |
响应参数 | ||
参数 | 是否必须 | 参数说明 |
result | 是 | 0:成功 1:失败 |
msg | 否 | result为1时,返回错误原因,例如:核销码已核销、核销码不存在等 |
data | 否 | result为0时,返回的核销奖品信息 |
响应示例 返回JSON格式结果。 | ||
成功 | {"result":0,"msg":"ok","data":{"product_id":"","product_name":"","verify_time":""}} | |
失败 | {"result":1,"msg":"核销码已核销"} | |
data参数说明
| 参数 | 数据类型 | 参数说明 |
| product_id | int(11) | 奖品(商品)ID |
| product_name | string(60) | 奖品(商品)名称 |
| product_image_url | string(200) | 图片地址 |
| product_type | int(11) | 奖品/商品类型枚举(1:实物;5:优惠券;12:商品;13:活动报名;15:表单;16:预约;17:微信卡劵) |
| product_detail | string(200) | 兑换劵时有值 |
| openid | string(128) | 参与人唯一标识 |
| nickname | string(60) | 参与人昵称 |
| headimgurl | string(200) | 参与人头像地址 |
| create_time | datetime | 参与时间 |
| verify_time | datetime | 核销时间 |
{
"app_key": "96c84928b1dce057d110ea3b3880fc83",
"time_stamp":"1543999047492",
"sign":"051BF3517D40AB9D7D6B45EF6E4EB7F9",
"verify_code":"123456",
"memo":"APP核销"
}
返回值示例,json格式 Content-type: application/json
{
"result": 0,
"data": {
"product_id": "10001",
"product_name": "小礼品1",
"product_image_url": "https://qn-file.rrxiu.net/prize_icon_v2.png",
"product_type": 1,
"openid": "gb_1543999047492",
"nickname": "小张子",
"headimgurl": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TMaE…zXTfZQugNBA/132"",
"create_time": "2099-09-10 09:00:00",
"verify_time": "2099-09-10 09:10:00",
},
"msg": "ok"
}