接口说明

优质

小牛编辑

129浏览

2023-12-01

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

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

加积分接口使用场景：

1、签到活动：30天日历签到、拉新签到、契约签到

2、活动工具活动：pk赛、积分夺宝、无敌挖矿机

3、退货退积分：积分兑换实物的订单，用户申请退货退积分时，通过加积分接口给用户退回积分

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

响应的结果只有两种：成功（ok）或者失败（fail）。

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

注意：如果开发者接口响应失败或者响应异常，加积分接口会进行重试。

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

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

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

图1：正常流程

图2：异常流程