该文档主要是为了解决外部游戏接入数据中心的网管配置信息,节约游戏接入流程。
1、 有新服务器配置或服务器配置变动时要及时更新接口返回数据,保证数据的准确一致性;
2、 接口采用Http Get协议,返回内容以Json字符串展示;
1、 协议参数:
字段 |
描述 |
备注 |
gameid |
游戏编号 |
该值是指定字符,由动网给出具体编号,游戏原样输出:如(000200FK) |
time |
请求时系统时间 |
Unix时间,1970年起以秒为单位 |
sign |
验证签名 |
md5(“gameid=”+ gameid +“&time=” + time + “&key=” + key) |
2、 数据加密:
每条协议指令中必须包含gameid ,time及sign参数以进行合法验证。
签名验证方法:请咨询动网先锋-数据部
Key由双方约定:请咨询动网先锋-数据部
3、 请求示例:
http://www.XXX.com/cmd_type/cmd?gameid=000200FK&time=1234567890&sign=abcdef123456
4、 返回参数解释:(返回参数全部小写)
字段 |
描述 |
备注 |
servertype |
游戏合作方名称 |
1、 小区数据库返回具体合作方名称的英文名称:如(tencent,360); 2、 大区数据库返回游戏大区相关:如(战龙三国相关1,战龙三国相关2) |
serverid |
服编号 |
1、 小区数据库返回具体服编号SN:如(S1,S2…必须带有大写S); 2、 大区数据库返回空即可 |
hostname |
游戏服域名 |
如:s1.app100646209.qqopenapp.com |
serverip |
游戏数据库IP信息 |
返回游戏数据库IP信息:如(10.182.44.25) |
port |
游戏数据库Prot信息 |
返回游戏数据库port信息:如(3306) |
dbname |
游戏数据库dbname信息 |
返回游戏数据库dbname信息:如(zlsg_qq_s1) |
servicetype |
游戏数据库分类,该值为指定字符(根据游戏而定,必须有db类型) |
1、 db:代表游戏用户相关信息; 2、 logdb:代表用户操作日志信息 |
Software |
数据库软件类型 |
该值是指定字符:如(mysql) |
{"msgnum":0,"msginfo":"","data":
[
{"servertype":"tencent","serverid":"S1","hostname":"s1.app100646209.qqopenapp.com","serverip":"10.142.1.40","port":"3306","dbname":"zlsg_qq_s1","Servicetype":"db","software":"mysql"},
{"servertype":"tencent","serverid":"S1","hostname":"s1.app100646209.qqopenapp.com","serverip":"10.142.1.41","port":"3306","dbname":"zlsg_qq_log_s1","Servicetype":"logdb","software":"mysql"},
{"servertype":"tencent","serverid":"S2","hostname":"s2.app100646209.qqopenapp.com","serverip":"10.142.1.40","port":"3307","dbname":"zlsg_qq_s2","Servicetype":"db","software":"mysql"},
{"servertype":"tencent","serverid":"S2","hostname":"s2.app100646209.qqopenapp.com","serverip":"10.142.1.41","port":"3307","dbname":"zlsg_qq_log_s2","Servicetype":"logdb","software":"mysql"},
{"servertype":"战龙三国相关","serverid":"","hostname":"","serverip":"10.142.1.40","port":"3304","dbname":"zlsg_qq_inpour","servicetype":"db","software":"mysql"},
{"servertype":"战龙三国相关","serverid":"","hostname":"","serverip":"10.142.1.40","port":"3303","dbname":"zlsg_qq_account","servicetype":"db","software":"mysql"}
],"msginfo":""
}
说明:msgnum为0时返回data信息,其他状态非成功状态,返回具体的异常信息(如:
{"msgnum":1,"msginfo":"sign错误","data":""})