# 服务端API

域名联系李志亮获取
请求均需使用https
非特殊说明情况下，均使用GET

# 1、验证票据

# 请求路径

https://域名/cas/validate.signature

# 功能说明

该接口一般用于web站点接入使用
该接口访问需要鉴权，具体参见"附录"->"其他 SDO 服务端"->"SDO API访问鉴权"

# 请求参数

字段名	类型	必填	说明
appId	string	Y	应用编码，整数；示例：appId=201``此appId请通过数字编码申请流程进行申请，第三方应用请联系公司接口人
areaId	string	N	应用区号，整数；示例：areaId=1
ticket	string	Y	票据，web登录组件或windows客户端登录组件完成登录后获得
customSecurityLevel	int	Y	自定义安全级别，固定传入2
endpointIp	string	N	客户端ip

# 业务响应

{"return_code": 0,"return_message": "","data": {下述表格描述此处字段}}

字段名	类型	说明
appId	string	登录的应用编码
displayAccount	string	账号用于显示的字符串
gameAccount	string	认证系统给游戏生成的账号标识(部分游戏需要)
inputUserId	string	输入账号
isDynamicPwdSet	int	游戏锁设置情况：0=关闭、2=仓库/元宝开启、3=仓库/元宝/角色开启开启了游戏锁的游戏资源需要验证叨鱼动密后解除限制
isStaticPwdLocked	int	是否开启了静密锁：0=否、1=是
loginEndpointIp	string	登录客户端ip
ptId	string	pt账号
sndaId	string	数字账号
verifyPhoneStatus	int	安全手机绑定状态，1=未绑定、2=绑定并验证期中、3=绑定并已通过验证期
thirdUserId	string	合作三方账号标识

示例

{
    "return_code": 0,
    "error_type": 0,
    "return_message": "",
    "data": {
        "appId": 991000350,
        "displayAccount": "qq1026517399",
        "gameAccount": "#049ae7e79",
        "inputUserId": "qq1026517399",
        "isDynamicPwdSet": 0,
        "isStaticPwdLocked": 0,
        "loginEndpointIp": "125.106.153.71",
        "ptId": "qq1026517399",
        "sndaId": "1236172409"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 业务错误

错误码	错误描述	详细说明
-10515010	无效的票据	票据不是由认证中心生成或者是已经验证过的
-10515016	appid不一致	入参appid和票据对应的appid不一致，请检查接入参数
-10515006	登录凭证失效	生成票据的登录态已过期或被玩家退出
-10515017	appid不一致	入参appid和票据对应的登录appid不一致，请检查接入参数
-10515024	ip多次验证	同一个登录态只允许一个ip验证一次票据
-10515025	appid登录信息无效	web登录的站点域名不是信任域名
-10515032	用户登录未达到应用要求的安全等级	用户登录未达到应用要求的安全等级
-10515033	验证时对应的登录末完成	可能是安全设备验证、实名补填等未完成
-10742155	禁止登录	账号在GMM出售，不允许该错误只有传世2001区或龙之谷手游双端联动有效

← SDO 服务端API访问鉴权 SDO 服务端SDK-SDOBASE →