礼包发送(TapTap)

WARNING

注意:: 该协议可选， 如果游戏上架TapTap平台，并需要配置TapTap平台的礼包直达功能时，需要接入该协议。

前置操作

1、 TapTap的礼包直达活动，需要依赖客户端角色上报接口。 请参考：

• Android角色数据上报接口
• iOS角色数据上报接口

2、 TapTap后台配置的礼包码URL地址：

• 获取服务器列表的URL： {官网SDK服务端URL}/tap/direct/gift/servers
• 获取角色列表的URL： {官网SDK服务端URL}/tap/direct/gift/roles
• 发送礼包的URL： {官网SDK服务端URL}/tap/direct/gift/send

在TapTap开发者后台如下图进行配置：

签名规则

登录认证协议中的sign字段生成规则如下：

1）除了sign字段和值为空的字段， 将其余字段按照字段key值的升序排列， 然后按照key=value&key=value.....拼接成字符串。（注意接收到字段后，需要先进行url decode，再进行签名计算）；

2) 将上述生成的字符串，最后附加&secretKey={SDK Key参数}格式生成待签名字符串。 {SDK Key参数}替换为分配的游戏【AppSecret】参数；

3）对上面得到的待签名字符串，做md5(32位大写)计算，生成对应的sign。

协议内容

当用户在TapTap App中领取礼包时， 会触发该协议，通知游戏服务器给玩家发放礼包。

1 请求协议

请求地址：游戏服务器提供，并配置到官网SDK后台-》配置管理-》登录配置-》礼包直达URL字段
请求方式：POST
请求参数格式：application/x-www-form-urlencoded
参数编码： UTF-8

请求参数：

参数名称	参数类型	参数说明
timestamp	String	时间戳，单位毫秒
serverID	String	游戏服务器ID
roleID	String	玩家在该服务器中的角色ID
giftCode	String	礼包码，和TapTap后台配置的一致
userID	String	官网SDK中该玩家的唯一用户ID
tapOpenID	String	玩家在TapTap平台的openID
tapUnionID	String	玩家在TapTap平台的unionID
sign	String	签名，签名算法规则见下方《签名规则》部分，这里使用的secretKey是分配的【AppSecret】参数

2 响应内容

礼包发放成功，返回字符串：SUCCESS。 发放失败，返回字符串：FAIL。

礼包发放URL配置

协议完成后， 请配置到官网SDK后台-》配置管理-》登录配置-》礼包直达URL字段：