兑换记录接口

需求场景:

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

接口说明:

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

接口参数说明

输入参数(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直达方式去访问兑换记录详情页面(免登录地址的生成方式,详见免登录地址

results matching ""

    No results matching ""