游戲數(shù)據(jù)接口說明.doc

游戲數(shù)據(jù)接口說明游戲數(shù)據(jù)接口說明1cboss系統(tǒng)數(shù)據(jù)接口1Gm平臺控制接口2cboss系統(tǒng)數(shù)據(jù)接口1、 說明：這里定義了游戲提供給cboss系統(tǒng)的數(shù)據(jù)結(jié)構(gòu)及操作流程。2、 操作流程：每個游戲線路，會收集玩家角色在該線路的登錄信息，并定時（如：間隔10分鐘）發(fā)送一次下面定義的所有數(shù)據(jù)到cboss系統(tǒng)提供的http接口。3、 數(shù)據(jù)定義：4、 當前在線人數(shù)(sum)5、 角色上下線記錄(roles)6、 接口定義：http接口使用post協(xié)議提交數(shù)據(jù)，數(shù)據(jù)使用json格式，并用zip方式壓縮；字符串數(shù)據(jù)使用utf-8編碼；json格式：num: 當前在線人數(shù), roles: 角色上下線記錄角色上下線記錄json格式：角色名, 等級, 登錄時間, 退出時間, .例子：num: 100, roles: abc, 10, 1112291212, 1112291812, ddd, 11, 1112291212, 1112291812上面例子經(jīng)過Zip壓縮后數(shù)據(jù)：xx9cxabVxca+xcdUxb2R040xd0QP*xcaxcfI-x06xf2xa2xa3x95x12x93x92x95tx80xc2QCCC#KC#C#%x04xcfx02xc8x8bxd5Qx88VJIIx01)4xc4xab0xb6x16x00x13xc3x17T7、 Cboss系統(tǒng)http接口地址：Gm平臺控制接口1、 說明：這里定義了游戲提供給gm系統(tǒng)的數(shù)據(jù)結(jié)構(gòu)及其操作流程。2、 操作流程：游戲提供http接口，gm系統(tǒng)使用http POST，調(diào)用游戲提供的http 接口。接口數(shù)據(jù)結(jié)構(gòu)和安全認證，使用dgapi相同的數(shù)據(jù)結(jié)構(gòu)和認證機制：認證機制：由游戲方發(fā)放gm用戶名和key給gm系統(tǒng)。gm系統(tǒng)使用key加密傳輸?shù)木唧w數(shù)據(jù)，并將gm用戶名和加密數(shù)據(jù)post到http接口；數(shù)據(jù)加密過程：encrypt_data = DGCrypt.encrypt(key, json_data)加密的數(shù)據(jù) = base64.b64encode(encrypt_data)數(shù)據(jù)解密過程：encrypt_data = base64.b64decode(加密的數(shù)據(jù))json_data = DGCrypt.decrypt(key, encrypt_data)數(shù)據(jù)結(jié)構(gòu)：client: gm用戶名, data:加密的數(shù)據(jù)具體細節(jié)參考dgapi；3、 接口定義：說明：http接口處理post協(xié)議提交的數(shù)據(jù)，原始數(shù)據(jù)使用json格式；數(shù)據(jù)中的字符串數(shù)據(jù)使用utf-8編碼；a) 獲取線路列表請求：barea:大區(qū)名, area:服名應(yīng)答：area_key:area_key, list:線路名, chl_key, ., .說明：area_key, chl_key代表對應(yīng)服或線路的唯一標識字符串，需要在后面使用；大區(qū)名、服名，從(:8080/config/area_svr.xml)地址獲??；b) 系統(tǒng)消息發(fā)送請求：發(fā)送到整個服：area_key:area_key, message:消息, chat_scope:世界, chat_type:消息類型, view_type:消息的顯示位置發(fā)送到特定線：chl_key:chl_key, message:消息, chat_type:消息類型, view_type:消息的顯示位置應(yīng)答：result:Result, fail:失敗的原因說明：chat_type：設(shè)定消息的類型：7=系統(tǒng)消息；view_type：設(shè)定消息顯示的位置：1=滾動位置c) 角色列表查詢請求：area_key:area_key, user_id:帳號id應(yīng)答：角色名, 性別, 等級, 職業(yè), ., .d) 角色詳細信息查詢請求：area_key:area_key, role:角色名應(yīng)答：uid:角色id, name:角色名, sex:性別, job:職業(yè), level:等級, exp:經(jīng)驗, last_leave:最后下線時間, total_online_time:總在線時間, acts:行動力, strength:力量, physique:體質(zhì), spirit:精神, intellect:智力, hp:生命值, ep:氣力值, bag_money:包裹錢, reel:禮卷, chl:當前線路名, forbid_logon:是否禁止登錄, forbid_chat:是否禁言e) 角色禁言請求：area_key:area_key, role:角色名, forbid_chat:是否禁言應(yīng)答：result:Result, fail:失敗的原因說明：要求角色在線f) 角色封禁請求：area_key:area_key, role:角色名, forbid_logon:是否禁止登錄應(yīng)答：result:Result, fail:失敗的原因說明：要求角色在線g) 角色行動力修改請求：area_key:area_key, role:角色名, acts:行動力應(yīng)答：result:Result, fail:失敗的原因說明：要求角色在線h) 角色修改等級請求：area_key:area_key, role:角色名, level:等級應(yīng)答：result:Result, fail:失敗的原因說明：要求角色在線i) 角色發(fā)錢幣請求：area_key:area_key, role:角色名, money:金錢應(yīng)答：result:Result, fail:失敗的原因說明：要求角色在線j) 郵件發(fā)送請求：area_key:area_key, roles:角色名, ., content:郵件內(nèi)容, items:物品id, 數(shù)量, .應(yīng)答：result:Result, fail:失敗的原因說明：items：郵件發(fā)送的物品列表，最多允許發(fā)送4種物品k)備注：a. 是否xxx的類型都為整型，