兑换记录同步接口

优质
小牛编辑
126浏览
2023-12-01

需求场景:

开发者有自己的商城兑换记录页面,想通过接口获取积分商城兑换记录的相关数据信息,并展示在自己兑换记录页面,可以通过兑换记录接口来接收积分商城的兑换记录内容。

接口说明:

兑换记录的数据传输接口是由开发者提供相关接口。兑吧服务器在有新的兑换记录产生的时候,通过该接口将兑换记录的相关信息传输给开发者服务器,开发者通过接口接收数据,在本地进行记录和相关处理,并给兑吧服务器响应处理结果。

接口参数说明

输入参数(Get请求方式)

字段名字段类型是否必须字段数码
appKeyStringYes接口appKey,应用的唯一标识
uidStringYes用户标识,唯一且不可变
recordIdStringYes兑换记录id
titleStringYes商品标题
logoUrlStringYeslogo图片地址
recordDetailUrlStringYes兑换记录详情页地址(访问时需包装成免登录url)
creditsStringYes积分
timestampStringYes1970-01-01开始的时间戳,毫秒为单位。
signStringYesMD5签名,参见【签名规则

响应参数

成功:响应ok

开发者服务器端收到兑换记录请求并处理完成后,请返回纯文本的 ok 字符串,两边不带空格,忽略大小写,兑吧在验证到响应为 ok 后就不再继续请求。

失败:除 ok 以外的任何响应。

兑吧会在之后的1分钟、3分钟、5分钟、10分钟、20分钟重复发送请求。

重复请求的处理

由于网络请求的无状态特性,兑吧向开发者发送请求以后,即便开发者已处理请求并返回响应,但是响应过程中因为网络问题导致兑吧没收到,兑吧无法确认该请求是否被正确处理,仍然会执行重发流程。

注意事项:开发者对于接收到的重复请求,需要做好兑换记录id的唯一性校验,对于网络原因引起的重复请求,如果本地已经有记录,则不要重复记录。

接口开发完成后,请联系兑吧技术支持协助接口配置。

同步兑换记录的使用场景

开发者通过接口接收到的兑换记录信息,展示积分商城外部的页面(开发者自己的兑换记录页面中),如果需要查到订单的具体状态,或者兑换记录的详情信息,则需要跳转到兑吧的兑换记录详情页面进行查看。具体流程如下(详见注释):此处输入图片的描述

跳转商城兑换记录详情页

因为兑换记录详情页面是兑吧的商城H5内页,访问时候需要拼装成免登录地址的redirect直达方式去访问兑换记录详情页面(免登录地址的生成方式,详见免登录地址