对接流程简介

注:本篇建议结合交互流程图一起阅读。

服务端对接

需对接接口

  1. 免登录URL接口
  2. 积分扣除接口
  3. 结果通知接口

接口形式

支持协议: HTTP / HTTPS

传参形式:GET

校验方式:MD5签名

1. 免登陆URL接口

功能: 提供给客户端作为积分商城的入口,通过该接口获取用户登陆信息(uid,积分),生成并重定向到免登录URL,加载后即进入兑吧积分商城首页

redirect:免登陆地址重定向跳转参数,通过该参数可以跳转到积分商城任意页面。

uid:用户唯一性标识符。

免登录URL:用于开发者跟兑吧交互用户信息,通过该URL实现用户静默登录积分商城。

URL有效时间:5分钟。需要在用户每次访问入口时,实时生成免登录URL,登录后cookie保留24小时。

接口地址:http://www.duiba.com.cn/autoLogin/autologin?

查看接口详细参数:免登陆接口参数

2. 扣积分接口

功能:用户在商城下单后,由兑吧发起扣除用户积分,并带上订单的详细信息。

开发者收到请求后需判断用户是否有足够积分下单,如果用户积分充足则预扣用户积分并返回成功的响应;如果积分不足或者其它不允许兑换的限制则返回扣积分失败的响应,并带上失败原因(兑吧会在手机端将失败原因展示给用户)。

扣积分超时处理

兑吧订单号order_num唯一,且一个order_num只会发送一次扣积分请求,请求超时时间为30秒。

如30秒未收到响应,订单即标记为失败,结果通知接口会发送失败通知。请求超时时获取不到开发者的订单号bizId,请根据兑吧orderNum来处理通知请求。

兑吧订单号order_num唯一,且一个order_num只会发送一次扣积分请求。

查看接口详细参数:扣积分接口

3. 结果通知接口

功能: 无论订单最终成功或失败,兑吧都会发送通知请求。

如果通知失败,开发者需根据订单号查询之前扣积分的情况,返还用户积分。

重发规则

通知请求包含重发规则,开发者收到通知请求,请返回 ok 纯字符串(不含双引号)。

任何除ok以外的响应兑吧都将进行重复通知,直到正确响应ok或者24小时内最多重复 8 次。间隔为:2m、10m、10m、1h、2h、6h、15h。

重复通知的处理

出于网络异常的可能性,兑吧可能会对开发者进行重复通知,开发者务必确保一笔订单不进行重复处理,否则将产生严重bug。

由于网络具有不稳定的特性,当兑吧向开发者服务器发送成功/失败通知时,可能存在兑吧发送了通知,开发者收到了通知并进行了处理。

若开发者返回响应给兑吧时出现网络故障,兑吧没有收到开发者的响应,兑吧无法确认开发者是否收到通知请求,会执行重发规则。

在上述情况下,开发者收到重复的通知时,务必先确认此订单是否已经处理过。如果已经处理过,则忽略此通知,并响应ok。 如果此时开发者忽略订单是否已经被处理过而直接进行处理,将导致开发者反复向用户返还积分,可能会造成损失!兑吧对此类未按兑吧要求处理而发生的损失事件概不负责。

查看接口详细参数:结果通知接口

客户端对接

积分商城为H5页面,会自动适配客户端屏幕(安卓支持4.0及以上版本,iOS全系列支持)

为了实现更好的用户体验,兑吧的部分功能需要客户端配合,建议根据需要实现兑吧默认的H5通讯协议。

客户端对接

扩展功能(按需对接)

如需接入自有虚拟商品,比如开发者想在自己平台直接为用户充值会员、红包、补签卡等自有虚拟商品,可以开通虚拟商品接口。(支付宝充值、Q币、话费为直充类商品,不属于虚拟商品,兑吧有专门商品类别提供兑换。)

虚拟充值商品

其它扩展功能(如会员等级、锁定充值账号等)不需要新增接口,仅需修改接口参数等,根据自身需求可以选择放在二期接入。
服务端开发语言如果是java、php、.net ,兑吧提供有服务端开发工具包,可在下载中心下载。

注意事项

results matching ""

    No results matching ""