加积分接口

API文档

接口说明

该接口由开发者服务端开放给兑吧

接口需求背景

为了优化积分商城内部的积分流通,提高用户的参与度,兑吧新增了多个积分运营场景,如:带有博弈性质的加减积分小游戏和连续签到加积分,这些运营场景都需要使用到开发者加积分接口。

接口流程说明

当用户在积分商城达成加积分的条件后,兑吧服务端会给上述配置的接口发送加积分请求,请求会带上加积分相关的必要信息,开发者收到请求后需生成订单、记录兑吧订单号及相关的加积分信息,并标记订单处理结果以方便回溯查询。同时,返回此次加积分请求的结果响应。

响应的结果只有两种:成功(ok)或者失败(fail)。

可参考流程图1:正常流程

重发机制处理

兑吧使用重发机制来处理加积分接口的请求异常。

兑吧设置请求超时时间为30秒,由于开发者服务器响应过慢或者网络异常等原因,兑吧在未收到开发者响应的情况下,会间隔30s、1min、2min后重发最多3次加积分请求。

注意:开发者收到重发的加积分请求时,需判断请求中该兑吧订单号(orderNum)是否已经被处理,如之前已处理过,则直接响应之前的处理结果给兑吧。切勿重复处理加积分,由此产生的损失,兑吧概不负责!

可参考流程图2:异常流程

附录:流程图

图1:正常流程
正常流程

图2:异常流程
异常流程

results matching ""

    No results matching ""