领取礼包接口
积分商城简介： 积分商城累计覆盖用户200w，累计兑换用户7.5W，累计兑换人次20w，每天新增人数6K-1w，商品种类300多种，覆盖电子数码、家居生活、游戏周边、玩具模型等各个领域
积分商城首页曝光图：
最好的推荐位，日点击数维持在2w左右，新品上线的时候会安排三天左右的排期进行首焦推广，目前有三国杀传奇、我叫MT2、天天西游酷跑、金蟾捕鱼、花样三国等十多种礼包接入积分商城，积分商城开设了游戏礼包专区
礼包详情页：
1.游戏推广黄金期，以礼包包装福利亮点，有更多理由和机会优先申请公共推广资源
2.积分商城全力推广，单日uv2w+，单月能消耗的礼包数1w-2w，每日可持续引导2000+用户进游戏。每个积分兑换成功用户即可直接跳转到游戏中！
一般游戏申请的积分额度如下：
1.不同产品星级会有各自的月总奖池和TOP奖限制；非TOP奖不能超过TOP奖的1/3
产品星级 |
每月可用 |
每个用户单次活动 |
单次活动 |
月累计 |
独代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)
参数说明：
回调接口原型：
public static interface IGetGiftListListener { public void onGetGiftListSuccess(List 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收到服务器返回的回调
回调接口原型：
publicstaticinterfaceITakeGiftListener {
publicvoidonTakeGiftListSuccess(booleanisSuccess);
publicvoidonTakeGiftListError(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”:”未找到发放记录” } |