用户积分增加接口

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

接口需求背景

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

接口流程说明

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

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

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

重发机制处理

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

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

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

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

输入参数(Get请求方式传参)

参数 是否必须 参数类型 限制长度 参数说明
appKey yes string 255 接口appKey,应用的唯一标识
uid yes string 255 用户标识,唯一且不可变
credits yes long 20 本次兑换增加的积分
type yes string 40 game(游戏), sign(签到), reSign(补签)。 hdtool(加积分活动)所有类型不区分大小写
orderNum yes string 255 兑吧订单号(请记录到数据库中)
timestamp yes string 20 1970-01-01开始的时间戳,毫秒为单位。
description no string 255 本次增加积分的描述(带中文,请用utf-8进行url解码)
ip no string 255 用户ip,不保证获取到
sign yes string 255 MD5签名,详见签名规则

响应参数

参数 是否必须 参数类型 限制长度 参数说明
status yes string 255 加积分结果状态,回复ok或者fail
errorMessage no string 255 出错原因
bizId yes string 255 开发者的订单号(唯一且不重复,如果失败该值可以不传)
credits yes long 20 用户积分余额

请使用JSON格式响应

响应示例

成功:
{
 "status":"ok",
 "errorMessage":" ",
 "bizId":"test-20140730192133033",
 "credits":"120"
}
失败:
{
 "status":"fail",
 "errorMessage":"失败原因",
 "credits":"100"
}

附录:流程图

图1:正常流程
正常流程

图2:异常流程
异常流程

results matching ""

    No results matching ""