帮助中心  /  核销接口

核销接口

接口功能说明

该接口用于第三方自有核销平台,完成核销人人秀平台奖品。


第三方核销接口


开发注意:

  • 该接口由人人秀提供给第三方开发者调用,第三方开发者调用该接口完成核销

  • 每次请用都需要重新生成签名,否则会提示签名过期

请求地址

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"

}


 

相关文档