增加积分接口

API文档

常见问题

接口说明

接口需求背景

为了优化积分商城内部的积分流通，提高用户的粘性和参与度，橙券积分商城内置了多个积分运营场景，如：参加连续签到活动获取积分，使用这些运营场景需要开发者提供增加积分的接口。增加积分接口为可选接口，开发者可根据自身运营需求合理地进行配置。

该接口由开发者开放给橙券积分商城

当用户产生增加积分的行为后，橙券积分商城将会创建一个订单，橙券积分商城会向商户配置的加积分接口发送一条该用户对应的增加积分请求。

这个请求会包含uid，橙券积分商城订单号，增加的积分数，参与活动类型等信息。开发者收到该请求后，请系统中创建加积分订单，并记录请求中的相关信息，同时执行用户积分增加操作，并返回此次加积分请求的结果响应。

如果增加积分成功，写入成功的参数和开发者系统的订单号，返回这个响应给橙券积分商城。

如果增加积分失败，写入失败的参数，并带上失败原因。橙券积分商城收到失败响应后会将这个加积分订单标记为失败。

增加积分行为可能会发生超时的情况，对于这种情况，橙券积分商城会尝试重复推送，会间隔30s、1min、2min后重发最多3次加积分请求。

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

增加积分超时处理方式

橙券积分商城向开发者发起增加积分请求时，橙券积分商城设置超时时间为10秒，由于开发者服务器响应过慢，或者网络异常等原因，可能会出现超时情况。 针对超时情况，橙券积分商城会尝试重复推送，会间隔30s、1min、2min后重发最多3次加积分请求。

附录：流程图

正常流程

异常流程