海外SDK 手游出海服务器接入技巧

手游海外市场正由蓝海逐渐变为红海中，所以要入场要趁早，接下来跟大家分享一下关于手游出海服务器的接入技巧。

一、简要说明

本文档的阅读对象为接入并使用SDK用户和支付系统的游戏服务器开发者。

通信时SDK均采用UTF8编码。

双发通信时，若有sign字段则一定要验证签名。

二、接口列表

2.1.验证用户信息接口

2.1.1.接口目的

游戏客户端从SDK登录回调中获取到uid后，为防止用户篡改客户端而伪造用户uid标示从而登录他人账号，游戏客户端应将此信息传入给游戏服务器。游戏服务器调用此接口向SDK验证uid的真实性。若uid通过验证则允许此用户登录，若无法通过验证应拒绝此用户的登录授权。

2.1.2.接口地址

http://gameyt.quicksdk.net/webapi/checkUserInfo

2.1.3.请求方式

GET/POST

2.1.4.参数列表

2.1.5.返回字段

接口会返回JSON格式字符串，如：

例1{“status”:false,”message”:”tokenUidError”}

例2{“status”:true,”message”:””}

2.1.6.请求示例

http://gameyt.quicksdk.net/webapi/checkUserInfo?token= 171 174 188 127 182 163 148 179 166 168 132 179 165 222 169 116 109 166 96 212 152 156 116 121 106 139 170 154 203 134 124 118 108 164 205 126 173 151 172 169 169 140 158 215 138 153 164 136 160 162 154 197 114 212 159 143 126 125 154 179 168 151 135 155 121 148 215 146 181 100 158 219 161 112 106 184 108 189 121 129 120 158 141 186 129 177 169 140 105 136 128 176 205 124 124 166 163 179 213 151 175 124 185 140 155 124 171 160&uid=523

2.2.发放道具接口

2.2.1.接口目的

玩家在完成充值后,SDK会按照此接口协议向游戏提供的发货地址POST数据（简称为发送通知），游戏在收到SDK POST的数据后应验证相关信息并向玩家发送道具。

游戏应按照第三章中的算法验证签名数据，确定请求是否合法。

游戏发货的金额应当以通知中的金额为准发放道具。

游戏应判断是否重复发放道具，若已发放则不能再次发放。

处理成功后返回SUCCESS这7个字母SDK将不再通知，否则SDK将在一段内持续通知

2.2.2.接口地址

发放道具地址由游戏提供，SDK会主动向此地址发起POST请求

2.2.3.请求方式

POST

2.2.4.POST参数列表

注：如果是官网充值方式时，CP可以获取extrasParams参数的值来定位到角色信息。这里的值CP可与第三方官网约定一个规则，让第三方官网按照规则传值。

2.2.5.请求示例

假设游戏在SDK后台配置的发货地址为http://xxx.com/notify

SDK会在玩家充值后向此地址POST如下参数：

uid=543&username=554230339%40qq.com&cpOrderNo=orderNo_xxx&orderNo=0020170210162721805701

&payTime=2017-02-10+16%3A27%3A55&payAmount=6.00&payStatus=0&payCurrency=RMB&usdAmount

=0.99&extrasParams=&sign=22abf0b204d19316d177baeec6a90fcd

CP接受到数据后应按第三章约定算法计算签名。

a)假设本地计算的签名与POST中传递的签名一致，则通过

b)若签名不一致，则返回FAILED，中断处理。

CP应判断是否已发送道具。

CP其他判断逻辑。

处理完成后。

a)希望SDK继续通知则返回任何非SUCCESS的字符。

b)处理完毕，订单结束则返回SUCCESS，SDK不会再通知。

2.3.Facebook活动礼包发放

2.3.1.接口目的

玩家在领取礼包之后,SDK会按照此接口协议向游戏提供的发货地址POST数据，游戏在收到SDK POST的数据后应验证相关信息并向玩家发送礼包。

游戏应按照第三章中的算法验证签名数据，确定请求是否合法。

游戏应判断是否重复发放礼包，若已发放则不能再次发放。

处理成功后返回SUCCESS这7个字母表示领取成功，否则判定领取失败。

2.3.2.接口地址

礼包发放地址由游戏提供，SDK会主动向此地址发起POST请求

2.3.3.接口地址

POST

2.3.4.POST参数列表

2.3.5.请求示例

假设游戏在SDK活动配置的礼包地址为http://xxx.com/notify

SDK会在玩家点击领取礼包时同步向此地址POST如下参数：

uid=543&giftNo=dwqu18921hud9&sign=22abf0b204d19316d177baeec6a90fcd

CP接受到数据后应按第三章约定算法计算签名。

a)假设本地计算的签名与POST中传递的签名一致，则通过

b)若签名不一致，则返回FAILED，中断处理。

CP应判断是否已发送礼包。

CP其他判断逻辑。

处理完成后，返回SUCCESS表示用户领取成功，否则为失败。

三、签名算法描述

通信时，发起方会在请求中附带sign字段。

接收方收到消息后将收到的键值对POST参数，移除sign后，按首字母升许排序。

将所有键值对按key1=val1&key2=val2&key3=val3&格式进行拼接。

在第3步拼接的字符后拼接SDK约定的callbackKey则此时格式为：key1=val1&key2=val2&key3=val3&callbackKey

将第4步处理的字符串进行md5编码，得到32位md5值。

将第5步获取的md5值与第1步中发起方传递的sign值进行对比，一致则通过。

代码片段参见第四章。

四、代码片段

相关推荐: 未注册PSE，PayPal、雅虎等平台被印尼封杀

厦门商城系统开发 DNY123获悉，印尼通信和信息技术部宣布封杀支付网关平台PayPal和雅虎搜索引擎，由于这些平台没有注册PSE。   游戏平台Steam、Origin，游戏Dota 2、CS:GO以及游戏发行商Epic Games也被禁止访问。   根据规…