兑换记录同步接口
优质
小牛编辑
126浏览
2023-12-01
需求场景:
开发者有自己的商城兑换记录页面,想通过接口获取积分商城兑换记录的相关数据信息,并展示在自己兑换记录页面,可以通过兑换记录接口来接收积分商城的兑换记录内容。
接口说明:
兑换记录的数据传输接口是由开发者提供相关接口。兑吧服务器在有新的兑换记录产生的时候,通过该接口将兑换记录的相关信息传输给开发者服务器,开发者通过接口接收数据,在本地进行记录和相关处理,并给兑吧服务器响应处理结果。
接口参数说明
输入参数(Get请求方式)
字段名 | 字段类型 | 是否必须 | 字段数码 |
---|---|---|---|
appKey | String | Yes | 接口appKey,应用的唯一标识 |
uid | String | Yes | 用户标识,唯一且不可变 |
recordId | String | Yes | 兑换记录id |
title | String | Yes | 商品标题 |
logoUrl | String | Yes | logo图片地址 |
recordDetailUrl | String | Yes | 兑换记录详情页地址(访问时需包装成免登录url) |
credits | String | Yes | 积分 |
timestamp | String | Yes | 1970-01-01开始的时间戳,毫秒为单位。 |
sign | String | Yes | MD5签名,参见【签名规则】 |
响应参数:
成功:响应ok
开发者服务器端收到兑换记录请求并处理完成后,请返回纯文本的 ok
字符串,两边不带空格,忽略大小写,兑吧在验证到响应为 ok
后就不再继续请求。
失败:除 ok 以外的任何响应。
兑吧会在之后的1分钟、3分钟、5分钟、10分钟、20分钟重复发送请求。
重复请求的处理
由于网络请求的无状态特性,兑吧向开发者发送请求以后,即便开发者已处理请求并返回响应,但是响应过程中因为网络问题导致兑吧没收到,兑吧无法确认该请求是否被正确处理,仍然会执行重发流程。
注意事项:开发者对于接收到的重复请求,需要做好兑换记录id的唯一性校验,对于网络原因引起的重复请求,如果本地已经有记录,则不要重复记录。
接口开发完成后,请联系兑吧技术支持协助接口配置。
同步兑换记录的使用场景
开发者通过接口接收到的兑换记录信息,展示积分商城外部的页面(开发者自己的兑换记录页面中),如果需要查到订单的具体状态,或者兑换记录的详情信息,则需要跳转到兑吧的兑换记录详情页面进行查看。具体流程如下(详见注释):
跳转商城兑换记录详情页
因为兑换记录详情页面是兑吧的商城H5内页,访问时候需要拼装成免登录地址的redirect直达方式去访问兑换记录详情页面(免登录地址的生成方式,详见免登录地址 ;