领取礼包接口

积分商城简介：积分商城累计覆盖用户200w，累计兑换用户7.5W，累计兑换人次20w，每天新增人数6K-1w，商品种类300多种，覆盖电子数码、家居生活、游戏周边、玩具模型等各个领域

积分商城首页曝光图：

最好的推荐位，日点击数维持在2w左右，新品上线的时候会安排三天左右的排期进行首焦推广，目前有三国杀传奇、我叫MT2、天天西游酷跑、金蟾捕鱼、花样三国等十多种礼包接入积分商城，积分商城开设了游戏礼包专区

礼包详情页：

1.游戏推广黄金期，以礼包包装福利亮点，有更多理由和机会优先申请公共推广资源

2.积分商城全力推广，单日uv2w+，单月能消耗的礼包数1w-2w，每日可持续引导2000+用户进游戏。每个积分兑换成功用户即可直接跳转到游戏中！

一般游戏申请的积分额度如下：

1.不同产品星级会有各自的月总奖池和TOP奖限制；非TOP奖不能超过TOP奖的1/3

产品星级	每月可用积分奖励池	每个用户单次活动 TOP奖额度上限	单次活动 TOP奖人数上限	月累计 TOP奖人数上限
独代S	300000	2000	8	24
联运S	200000	1500	6	18
联运A	150000	1000	6	18

2.以游戏最近一周的DAU作为参考，可对以上全部数据可进行加成，加成如下：

周均DAU	加成
3万以上	1.5倍
6000~3万	1.0倍
6000以下	0.5倍

例如：5000DAU的独代产品单次用户最高发放1500积分、月累计可发放最多12人次。

附：礼包接入完毕，提供的物料需求

1.宣传图，3张JPG，690*450，600*600，240*156

2.礼包描述：150-300字

客户端领取礼包接口

获取礼包信息接口

接口说明：

获取礼包列表，适用于单机APP领取APP内礼包，调用此接口可获取礼包码列表。

前置条件：

需登录授权

函数原型：

public static void queryGifts(final IGetGiftListListener listener)
参数说明：

listener 礼包信息的回调

回调接口原型：

 public static interface IGetGiftListListener { 		public void onGetGiftListSuccess(List<Gift> list); 		public void onGetGiftListError(String errMsg); 	} 	public static class Gift { 		private String cpItemId; 		private Long giftId; 		private Long status

领取礼包

接口说明：领取礼物，从获取的礼包码ID列表中领取相应的礼包ID

前置条件：

1. 需要先通过“获取礼包信息”接口拿到可购买的商品的giftId

2. 需要登录授权

函数原型：

public static void takeGifts(long giftId, ITakeGiftListener listener)

参数说明：

giftId 要领取礼物的ID

listener收到服务器返回的回调

回调接口原型：

public static interface ITakeGiftListener {

public void onTakeGiftListSuccess(boolean isSuccess);

public void onTakeGiftListError(String errMsg);

}

服务端领取礼包接口

获取礼包信息接口

接口说明：

当用户通过各种渠道领取APP礼包后，APP启动时，APP客户端/服务端可以和向数娱APP后台查询，该用户是否有需要发放的礼包。查询成功，则返回一个记录列表。

前置条件：

需登录授权

函数原型：

http://gateway.6uu.com/coin/query_game_gift_record.action?user_str_id=xxx&app_str_id=xxx&game_item_id=xxx &status=0&ts=xxx&sign=xxx

参数说明：

请求参数
user_str_id	数娱用户Id				必选		String	xxxxx
game_item_id	购买的物品Id（此Id由CP提供，CP校验此物品ID合法性）。可不填，亦可填多个，逗号分隔（不填则返回该用户所有符合条件的记录）。				可选		String	12312312312
status	按状态对结果进行筛选。0为全部，1为待激活，2为已激活，3为已过期。默认为1。				可选		Int	1
app_str_id	APPappkey				必选		String	12654
ts	时间戳				必选		long	223433232
sign	签名当前请求的数据进行签名，必须可选要根据当前Request请求中的数据项而定，不能写死在代码中。				必选		String	Sdf98sdf98sdf89sdf9sdf9sd
成功返回
is_success		请求处理是否成功			必选		String	T
record_list		返回APP服务器创建订单后的订单ID			必选		String	返回的信息中以下字段代表礼包ID cpItemId
失败返回
is_success		请求处理是否成功	必选	String		F
error_code		错误码	必选	String		605
msg		错误信息	必选	String		请求失败

响应样例：

成功返回

有2个礼包

{

“is_success”:”T”,

“record_list”: [{"cpItemId":"4698796","gmtCreate":1433948755664,"recordId":65498,"status":1,"userStrId":"654987asdf987sadf"},{"cpItemId":"98964654","gmtCreate":1433948755664,"recordId":658796,"status":1,"userStrId":"654987asdf987sadf"}]

}

无符合条件的礼包：

{

“is_success”:”T”,

“record_list”: []

}

失败返回

{

“is_success”:”F”,

“error_code”:”FAIL”,

“msg”:”system error”

}

领取礼包

接口说明：

APP端完成礼包发放之后，通知数娱服务端，该礼包已成功激活，下次再请求待激活礼包列表时则不会返回该礼包。

函数原型：

http://gateway.6uu.com/coin/mark_record_as_activated.action?user_str_id=xxx&app_str_id=xxx&app_order_id=xxx&record_id=xxx&ts=xxx&sign=xxx
参数说明：

请求参数
user_str_id	数娱用户Id	必选	String	xxxxx
app_order_id	APP端完成发放所关联的订单id，有cp生成，数娱服务端只记录	必选	String	12312312312
record_id	查询记录时返回的记录id	必选	Long	654897
app_str_id	APPappkey	必选	String	12654
ts	时间戳	必选	Long	223433232
sign	签名当前请求的数据进行签名，必须可选要根据当前Request请求中的数据项而定，不能写死在代码中。	必选	String	Sdf98sdf98sdf89sdf9sdf9sd
成功返回
is_success	请求处理是否成功	必选	String	T
app_order_id	返回APP服务器创建订单后的订单ID	必选	String	1231231
失败返回
is_success	请求处理是否成功	必选	String	F
error_code	错误码	必选	String	FAIL
msg	错误信息	必选	String	请求失败

响应样例

成功返回

{

“is_success”:”T”,

“app_order_id”:“1235654”

}

失败返回

该礼包记录已激活过或已过期

{

“is_success”:”F”,

“app_order_id”:“1235654”，

“error_code”:”RECORD_STATUS_INVALID”,

“msg”:”礼包状态错误”

}

该礼包记录不存在

{

“is_success”:”F”,

“app_order_id”:“1235654”，

“error_code”:”RECORD_NOT_FOUND”,

“msg”:”未找到发放记录”

}

领取礼包接口

服务端领取礼包接口

Chinesische PHP-Website