2.1.1 checkLogin验证用户接口
- 接入要求:登录必接。
- sdk版本:sdk2.x以上。
版本说明:
版本号 |
日期 |
说明 |
V1.0 |
2021-01-05 |
初始版本 |
V1.1 |
2021-01-20 |
固定请求url,cp只需调整sandbox的参数即可更换验证环境。 |
简要描述:
- 玩家在sdk登录成功后,sdk client 会将玩家的token 传递给CP client。
- CP Server向此接口发送请求验证玩家登录信息的token的正确性并返回uid。
- CP Server获取到uid后需将该uid返回给sdk client。
- sdk client 最终提示玩家,登录成功。
- 此接口适用于sdk2.x版本
请求URL:
https://sdk.ulugame.com/v2/api/member/user/checkLogin
请求方式:
参数携带方式:
请求体参数:
参数名 |
必选 |
类型 |
说明 |
token |
是 |
string |
从客户端向用户登录验证地址发送的token,请注意token的长度不要被截断 |
sandbox |
是 |
int |
0:正式环境,1:沙盒环境 ;是否是沙盒环境,该信息是由客户端配置参数而来,默认正式环境 ,如此参数不传,将验证正式环境,cp Server 需自己判断 校验情况 |
请求示例:
{
"token":"token.value=====",
"sandbox":1
}
返回参数说明
参数名 |
类型 |
说明 |
code |
int |
状态码:0为成功,其他为失败的错误码 |
data |
成功返回对象,失败返回null |
成功为:该token所属uid |
msg |
失败返回字符串 |
失败为失败信息 |
成功返回示例
{
“code”:0,
"msg": null,
“data”:{
“uid”:”1197329976064507905”
},
}
失败返回示例
{
"code":1,
"msg": "Invalid Value",
"data":null
}
{
"code": 30010,
"msg": "token is null or empty",
"data": null
}
备注
- 多数登录错误情况为cp server没能判断清楚游戏包的登录环境,即:游戏出了sdk为沙盒的包,而sandbox=0,请求了到了正式url。去sdk正式服验证登录信息,导致了 token验证失败。
- 此接口必接,且每次登录包括自动登录都要进行验证。否则(有游戏出现了)可能会出现游戏串号现象发生。