3.1:游戏用户登录模块

接入简介

游戏服务器在接收到客户端回传的登录信息后,向SDK服务器校验登录token合法性的服务

登录流程图

1-调起登录
2-请求token
3-返回token
4-返回token
5-转发token
6-验证token
7-返回验证结果
游戏客户端
SDK客户端
SDK服务器
游戏服务器
  1. 游戏客户端调起SDK客户端
  2. 游戏用户SDK客户端,输入用户名和密码后,SDK客户端向SDK服务器请求用户token
  3. SDK服务器完成用户认证后,返回SDK客户端用户的token和其他信息
  4. SDK客户端回传用户token给游戏客户端
  5. 游戏客户端将登录token回传游戏服务器
  6. 游戏服务器向SDK服务器发送登录验证请求
  7. SDK服务器返回验证结果给游戏服务器
  8. 游戏服务器根据验证结果处理具体逻辑

注:以上是通用流程,CP服务端接入只需关注第6,7,8点

接入细节

编码要求

服务端代码文件存储格式一律要求使用utf-8 without bom,否则可能会出现数据编码错误

SDK服务端校验API地址

https://open3.badambiz.com/api/account/check_token/    (注意:HTTPS 协议 POST 方法)

请求协议

字段名 类型 是否必填 描述
a 字符串 游戏APPID
t 字符串 秒级别10位时间戳,UTC+8时区
d 字符串 open_id和token的json字符串,如 {"open_id": "123", "token": 456}
s 字符串 加密字符串
s加密规则

d + api secret + t 拼接为字符串后做md5加密,所得的字符串即为s。其中api secret为应用的加密密钥

注意:

Post请求API报文的方式 `Content-Type: application/x-www-form-urlencoded`
例子
字段 说明
a ee1884a9ec0f7f50a7e39636c0d7106f 应用ID, 从 后台获取
t 1535698503 时间戳
d {"open_id": "123", "token": 456} open_id和token的json字符串

将 d, api secret, t这几个字段拼接得到字符串,假设api secret为cf9cab9b922b43dc26252ac25b42829b:

{"open_id": "123", "token": 456}cf9cab9b922b43dc26252ac25b42829b1535698503

对上述字符串进行MD5加密然后得到 142fa446bac847ec0db395d75b2ea897 字符串.

在线测试地址

响应协议

字段名 类型 是否必填 描述
result 整型 结果.0成功,非0失败
message 字符串 错误信息
data 结构体 结果数据

响应说明

SDK登录验证获取的数据统一以JSON格式返回,其中包含result,message,data三个子域部分

  1. result:表示验证请求是否成功,0-表示验证成功,非0 表示验证失败
  2. message:错误信息
  3. data:无

成功返回示例: { "result": 0 }

失败返回示例:

{
    "message": "授权失败",
    "result": 3
}

results matching ""

    No results matching ""