玩家信息接口

一. 接口说明

  • 接口例子:

    http://api.gameurl.com/api/get_player_info.php?username=1499306159&serverid=1&time=130674873&flag=e89f29e5d0b811195c52832269d0e22b

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

  • 接口请求方式
    需要同时支持 "GET" 和 "POST" 两种传参方式

二. 参数说明

参数 说明 例子 备注
username 平台uid 1499306159 与登陆接口的username一致
serverid 服务器id 1 对应的服务器id，如果没有服务器id，则为空
time UNIX时间戳 130674873 加密的验证里面要该参数
flag 加密串 e89f29e5d0b811195c52832269d0e22b md5(username + serverid + time + 密钥)

三. 返回值说明

返回值说明 返回值 备注
正常返回数据(单角色) [{"userid":1234,"nickname":"abcd","level":"13","money":{"bind":1,"normal":100}}]
  • userid : 即平台id 参数说明中的username
  • nickname : 即用户在游戏的昵称,返回格式为JSON;
  • level : 即用户在游戏中的等级
  • money : 即用户在游戏中的游戏币库存, bind:绑定游戏币(如绑定元宝), normal:充值获得的游戏币, 如果没有区分绑定游戏币 则bind的值为0

  • 如果有多个角色，则返回多个角色信息。
  • [{"userid":1234,"nickname":"abcd","level":"13","money":{"bind":1,"normal":100}},{"userid":1234,"nickname":"hijk","level":"10","money":{"bind":0,"normal":100}}]
未知错误 0
用户不存在 2
ip限制 3 若不需要限制ip，则不会返回此值
参数错误 4
验证错误 5

四. 接口测试

ERROR 403

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

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