游戏数据接口说明.doc

游戏数据接口说明游戏数据接口说明1cboss系统数据接口1Gm平台控制接口2cboss系统数据接口1、 说明：这里定义了游戏提供给cboss系统的数据结构及操作流程。2、 操作流程：每个游戏线路，会收集玩家角色在该线路的登录信息，并定时（如：间隔10分钟）发送一次下面定义的所有数据到cboss系统提供的http接口。3、 数据定义：4、 当前在线人数(sum)5、 角色上下线记录(roles)6、 接口定义：http接口使用post协议提交数据，数据使用json格式，并用zip方式压缩；字符串数据使用utf-8编码；json格式：num: 当前在线人数, roles: 角色上下线记录角色上下线记录json格式：角色名, 等级, 登录时间, 退出时间, .例子：num: 100, roles: abc, 10, 1112291212, 1112291812, ddd, 11, 1112291212, 1112291812上面例子经过Zip压缩后数据：xx9cxabVxca+xcdUxb2R040xd0QP*xcaxcfI-x06xf2xa2xa3x95x12x93x92x95tx80xc2QCCC#KC#C#%x04xcfx02xc8x8bxd5Qx88VJIIx01)4xc4xab0xb6x16x00x13xc3x17T7、 Cboss系统http接口地址：Gm平台控制接口1、 说明：这里定义了游戏提供给gm系统的数据结构及其操作流程。2、 操作流程：游戏提供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；3、 接口定义：说明：http接口处理post协议提交的数据，原始数据使用json格式；数据中的字符串数据使用utf-8编码；a) 获取线路列表请求：barea:大区名, area:服名应答：area_key:area_key, list:线路名, chl_key, ., .说明：area_key, chl_key代表对应服或线路的唯一标识字符串，需要在后面使用；大区名、服名，从(: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) 角色列表查询请求：area_key:area_key, user_id:帐号id应答：角色名, 性别, 等级, 职业, ., .d) 角色详细信息查询请求：area_key:area_key, role:角色名应答：uid:角色id, name:角色名, sex:性别, job:职业, level:等级, exp:经验, last_leave:最后下线时间, total_online_time:总在线时间, acts:行动力, strength:力量, physique:体质, spirit:精神, intellect:智力, hp:生命值, ep:气力值, bag_money:包裹钱, reel:礼卷, chl:当前线路名, forbid_logon:是否禁止登录, forbid_chat:是否禁言e) 角色禁言请求：area_key:area_key, role:角色名, forbid_chat:是否禁言应答：result:Result, fail:失败的原因说明：要求角色在线f) 角色封禁请求：area_key:area_key, role:角色名, forbid_logon:是否禁止登录应答：result:Result, fail:失败的原因说明：要求角色在线g) 角色行动力修改请求：area_key:area_key, role:角色名, acts:行动力应答：result:Result, fail:失败的原因说明：要求角色在线h) 角色修改等级请求：area_key:area_key, role:角色名, level:等级应答：result:Result, fail:失败的原因说明：要求角色在线i) 角色发钱币请求：area_key:area_key, role:角色名, money:金钱应答：result:Result, fail:失败的原因说明：要求角色在线j) 邮件发送请求：area_key:area_key, roles:角色名, ., content:邮件内容, items:物品id, 数量, .应答：result:Result, fail:失败的原因说明：items：邮件发送的物品列表，最多允许发送4种物品k)备注：a. 是否xxx的类型都为整型，