1.1 本接口的游戏地址为有规则的地址,如s1.sq.uwan.com,根据服务器ID自动调用地址请求;如果游戏有特殊的地址请告知修改成你们设定具体的地址,使接口正常使用;
1.2 登陆,充值,角色查询为所有游戏通用接口,其他接口都是个别平台的,根据游戏自行根据联运平台开发(注意:登陆,充值,角色查询必须要实现);如果是新游戏第一次接入联运的话建议全部接口一次接入完毕,这样就支持我们已经接入的联运平台;
现有提供的全部接口(如果已接入4399那就只要实现1-4接口,以后需要再接入,因为5-7现在只有4399需要):
1)登陆接口
2)充值接口
3)角色账号验证接口
4)角色信息查询接口
5)禁言、踢下线接口(暂时支持4399)
6)封号接口(暂时支持4399)
7)游戏服每天5分钟在线接口(暂时支持4399)
8)百度实时post角色信息接口(暂时支持百度,游戏自己实现POST)
4399还有一部分数据接口需要自己对接,这些接口需要游戏和对方协调数据,请参考(http://doc.my4399.com/wiki/Index),其他平台已经全部提供
1.3运营和游戏需要提供接口配置的相关资料信息:
运营提供信息:
1)联运登陆密钥(SECRET_KEY)
2)联运充值密钥(RECHARGE_KEY)
3)如果接入联运平台-百度,需要提供百度游戏开放平台分配给合作商户游戏的唯一编号(api_key)
4)提供游戏在联运平台的对应官网地址,登陆游戏失败将需要跳转到官网
5)除了以上信息,还有一些具体的联运信息根据对方平台需要收集提供
游戏提供接口(第一次开发全部提供,其他情况根据需要提供):
1)登陆接口
2)充值接口
3)角色账号验证接口
4)角色信息查询接口
5)禁言、踢下线接口
6)封号接口
1.4 建议每个游戏自己搭建一个PHP服务器做接口中转,同个机房速度方面存在优势,代码会提供和更新给游戏。比如360需要接口压测达标才能验收接口的情况;
1.5 接口自身提供登陆和充值日志记录,在每个游戏目录下的logs按照每天一个文件夹记录,方便出现问题查找;
日志规则:
登陆:游戏标识_平台标识_login.log
充值:游戏标识_平台标识_charge.log
说明:“√”为支持,“×”为不支持
合作商(Plaf) |
登陆 |
充值 |
角色查询 |
角色验证 |
提交角色等级信息 |
禁言 |
踢下线 |
封号
|
游戏服每天5分钟在线
|
百度(baidu) |
√ |
√ |
√ |
× |
√ |
× |
× |
× |
× |
4399(4399) |
√ |
√ |
√ |
× |
× |
√ |
√ |
√ |
√ |
7k7k(7k7k) |
√ |
√ |
√ |
√ |
× |
× |
× |
× |
× |
甲子(jiazi) |
√ |
√ |
√ |
× |
× |
× |
× |
× |
× |
通用接口所有接口的命名都是统一的,不同的只是游戏的标识和平台标识,只要更改游戏标识和平台标识后提供给平台即可。
第2节“平台支持“上面的plaf就是平台标识
例如:石器时代的7k7k的登陆地址:
http://lianyun.dovogame.com/sq/7k7k/login.php
接口 |
地址 |
登陆接口 |
http://lianyun.dovogame.com/游戏标识/平台标识/login.php |
充值接口 |
http://lianyun.dovogame.com/游戏标识/平台标识/charge.php |
角色查询接口 |
http://lianyun.dovogame.com/游戏标识/平台标识/getUserRole.php |
角色账号验证接口 |
http://lianyun.dovogame.com/游戏标识/平台标识/checkRole.php |
禁言接口 |
http://lianyun.dovogame.com/游戏标识/平台标识/planTalk.php |
踢下线接口 |
http://lianyun.dovogame.com/游戏标识/平台标识/underLine.php |
封号接口 |
http://lianyun.dovogame.com/游戏标识/平台标识/planAccount.php |
游戏服每天5分钟在线接口 |
http://lianyun.dovogame.com/游戏标识/平台标识/getDay5.php |