登录接口
一. 接口说明
-
接口例子:
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相关技术人员