登录接口

一. 接口说明

  • 接口例子:

    http://api.gameurl.com/agentlogin.php?username=1&time=123412341&flag=e89f29e5d0b811195c52832269d0e22b&cm=1&site=smzt&serverid=1&account=A%e5%bc%a0%e4%b8%89

    接口地址由游戏方提供(格式可自定义),平台方只提供参数(接口例子的红色部分)

  • 登录错误情况:

    登录错误情况下(链接超时、加密验证错误)都需要跳转到官网地址

二. 参数说明

参数 说明 例子 备注
username 平台uid 1267645584

平台uid,值已超过21亿,如果是int类型必须设置成无符号类型

time UNIX时间戳 1498301607

发送请求时时间,必须根据参数值做超时验证,超时时间建议为5分钟

cm 防沉迷状态 1 0: 已经登记信息但没有满18岁(未通过防沉迷)
1: 已经登记信息并且已经满18岁(已通过防沉迷)
2: 没有登录信息(未通过防沉迷,应该提醒用户填写)
site 跳转站点 仅参与加密校验,不在根据这个参数跳转。登录错误情况下都需要跳转到游戏官网(官网地址找我方技术)
flag 加密签名 uAEu6IZ4yb0lUCVRzK8sa9LWewN31p2w 加密规则: md5 ( username + time + 登录接口秘钥 + cm + site + serverid )
serverid 服务器id 1 服务器id,如果新开是删档测试服则serverid为999,如果为正式服则从1开始
account 玩家账号 A张三

该值为urlencode后的值,可能会出现中文。(该参数只用于拼接充值跳转地址)

充值页面地址:https://cz.4399.com/xxx/?je=50&serverid=1&uname=A%e5%bc%a0%e4%b8%89

三. 返回值说明

返回值说明 返回值 备注
登录成功 正常进入游戏
验证失败 跳转到官网 登录错误情况下需要跳转到官网地址
链接超时 跳转到官网 登录错误情况下需要跳转到官网地址

四. 接口测试

ERROR 403

当前状态为文档访问模式,不支持接口测试功能

相关权限开通,请联系4399相关技术人员