2021年最新升级版OB游戏数据接口说明文档

游戏数据接口说明

游戏数据接口说明 (1)

cboss系统数据接口 (1)

Gm平台控制接口 (2)

cboss系统数据接口

一、说明：

这里定义了游戏提供给cboss系统的数据结构及操作流程。

二、操作流程：

每个游戏线路，会收集玩家角色在该线路的登录信息，并定时（如：间隔10分钟）发送一次下面定义的所有数据到cboss系统提供的http接口。

三、数据定义：

四、当前在线人数(sum)

五、角色上下线记录(roles)

六、接口定义：

http接口使用post协议提交数据，数据使用json格式，并用zip方式压缩；字符串数据使用utf-8编码；

json格式：{"num": 当前在线人数, "roles": 角色上下线记录}

角色上下线记录json格式：[[角色名, 等级, 登录时间, 退出时间], ...]

例子：{"num": 100, "roles": [["abc", 10, "1112291212", "1112291812"], ["ddd", 11, "1112291212", "1112291812"]]}

上面例子经过Zip压缩后数据：

'x\x9c\xabV\xca+\xcdU\xb2R040\xd0QP*\xca\xcfI-\x06\xf2\xa2\xa3\x95\x12\x93\x92\x95t\x80\x c2@QCCC##KC#C#%\x04\xcf\x02\xc8\x8b\xd5Q\x88VJII\x01)4\xc4\xab0\xb6\x16\x00\x13\xc3 \x17T'

七、Cboss系统http接口地址：

Gm平台控制接口

一、说明：

这里定义了游戏提供给gm系统的数据结构及其操作流程。

二、操作流程：

游戏提供http接口，gm系统使用http POST，调用游戏提供的http 接口。接口数据结构和安全认证，使用dgapi相同的数据结构和认证机制：

认证机制：由游戏方发放gm用户名和key给gm系统。gm系统使用key加密传输的具体数据，并将gm用户名和加密数据post到http接口；

数据加密过程：

encrypt_data = DGCrypt.encrypt(key, json_data)

加密的数据= base64.b64encode(encrypt_data)

数据解密过程：

encrypt_data = base64.b64decode(加密的数据)

json_data = DGCrypt.decrypt(key, encrypt_data)

数据结构：{'client': gm用户名, 'data':加密的数据}

具体细节参考dgapi；

三、接口定义：

说明：http接口处理post协议提交的数据，原始数据使用json格式；数据中的字符串数据使用utf-8编码；

a)获取线路列表

请求：{'barea':大区名, 'area':服名}

应答：{'area_key':area_key, 'list':[线路名, chl_key], [....], .....]}

说明：

area_key, chl_key代表对应服或线路的唯一标识字符串，需要在后面使用；

大区名、服名，从(http://www.doczj.com/doc/83dde417f18583d0496459f5.html:8080/config/area_svr.xml)地址获取；

b)系统消息发送

请求：

发送到整个服：{'area_key':area_key, 'message':消息, 'chat_scope':'世界', 'chat_type':消息类型, 'view_type':消息的显示位置}

发送到特定线：{'chl_key':chl_key, 'message':消息, 'chat_type':消息类型, 'view_type':消息的显示位置}

应答：{'result':Result, 'fail':失败的原因}

说明：'chat_type'：设定消息的类型：7=系统消息；

'view_type'：设定消息显示的位置：1=滚动位置

c)角色列表查询