QuickSDK-手游出海服务器接入技巧

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

一、简要说明

本文档的阅读对象为接入并使用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值进行对比，一致则通过。

代码片段参见第四章。

四、代码片段

QuickSDK（成都极娱网络科技有限公司）是一家为全球手游发行提供全栈解决方案的服务平台。自创立以来，全球已有超过7000款手游通过QuickSDK进行上线发行，其中包括多家手游龙头企业。通过SDK聚合工具、官方SDK系统、玩家维护系统、数据运营平台和QuickAD+五大核心服务功能，致力为手游发行商节省研发成本，提高发行效率和增加游戏收益。

最后

以上就是背后钢笔为你收集整理的QuickSDK-手游出海服务器接入技巧的全部内容，希望文章能够帮你解决QuickSDK-手游出海服务器接入技巧所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。