游戏账户安全平台交互消息接口规范说明.doc

游戏账户安全平台消息接口规范说明1 说明本接口说明游戏账户平台与各游戏中心的消息接口。该消息接口以长连接方式上承载的XML类型的封装方式通信。包括的消息有：游戏中心连接请求、游戏中心用户扣费与加值请求等。2 消息封装规范说明：1. I为消息间隔标志:rnrn,4BYTE。在连接上，如果持续读到rnrn，则表示新消息的开始。2. L为消息长度,int型，占4BYTE。L是指后续MSG HEADER+MSGBODY+4的总长度。3. T为消息类型ID。应答消息类型ID=请求消息类型ID+0xFF00;3 接口消息定义序号请求消息名称请求类型ID应答消息名称说明1.GAME_LOG_REQ0x01GAME_LOG_RES游戏服务联接账平台请求与应答2.HEAT_BEAT0x00心跳消息3.USER_AUTH_REQ0x02USER_AUTH_RES用户验证请求与应答4.USER_ACCOUNT_REQ0x03USER_AMOUNT_RES用户账户余额查看请求与应答5.USER_PAY_REQ0x04USER_PAY_RES用户支付请求与应答6.USER_ADD_REQ0x05USER_ADD_RES给用户加值请求与应答4 消息头部定义字段名字段类型字段含义说明MODULEIDINT模块ID由账户平台给每个游戏中心分配。MODULENAMESTRING模块名MODULEAUTHCODESTRING模块验证码由账户平台发送给各游戏中心的单次校验码，在一个连接内有效。初次连接为空。SESSIONCODESTRING会话ID请求与应答的会话ID必须一致ERRORFLAGINT错误标志0-无错1-出错ERRORSTRINGSTRING 错误信息没有错则为空5 消息体定义5.1 GAME_LOG_REQ字段名字段类型字段含义说明LOGNAMESTRING登录名LOGPWDSTRING密码MD5加密后的密文LOGTIMESTRING登录时间年月日时分,作为LOGPWD加密的明钥.LOGINFOSTRING其它登录说明5.2 GAME_LOG_RES字段名字段类型字段含义说明MODULEAUTHCODESTRING由账户平台返回的连接校验码5.3 HEAT_BEAT心跳消息为空消息体。5.4 USER_AUTH_REQ字段名字段类型字段含义说明USERNAMESTRING用户名USERPWDSTRING用户密码MD5加密后的密文。DOMAINIDINT当前登录域IDDOMAINPWDSTRING当前登录域密码MD5加密后的密文。5.5 USER_AUTH_RES(需要确认)字段名字段类型字段含义说明USERIDINT用户IDUSERNAMESTRING用户名USERRIGHTFLAGINT用户权限标识1-有权限0-无权限AUTH_INFOSTRING用户验证说明5.6 USER_PAY_REQ字段名字段类型字段含义说明USERIDINT用户IDDOMAINIDINT区IDDOMAINPWDSTRING区密码MD5加密PAYSEQUENCESTRING交易序列号用作对账用。PAYTYPENUMINT需要扣值类型数量PAYTYPEINT扣值类型系统可以处理多种值的扣减。在这里循环增加即可。PAYNUMINT扣减数量5.7 USER_PAY_RES字段名字段类型字段含义说明USERIDINT用户IDDOMAINIDINT区IDPAYSEQUENCESTRING交易序列号用作对账用。PAYTYPENUMINT需要扣值类型数量PAYTYPEINT扣值类型0- 失败1- 成功PAYRESULTINT扣减结果BALANCEINT扣减后余额5.8 USER_ ACCOUNT _REQ字段名字段类型字段含义说明USERIDINT用户IDDOMAINIDINT区IDDOMAINPWDSTRING区密码MD5加密5.9 USER_ ACCOUNT _RES字段名字段类型字段含义说明USERIDINT用户IDDOMAINIDINT区IDACCOUNTNUMINT账户类型数量ACCOUNTTYPEINT账户类型重复使用BALANCEINT账户余额5.10 USER_ ADD _REQ字段名字段类型字段含义说明USERIDINT用户IDDOMAINIDINT区IDDOMAINPWDSTRING区密码MD5加密ADDSEQUENCESTRING交易序列号用作对账用。ADDTYPENUMINT账户类型数量ACCOUNTTYPEINT账户类型重复使用ADDNUMINT账户增加数5.11 USER_ADD_RES字段名字段类型字段含义说明USERIDINT用户IDDOMAINIDINT区IDADDSEQUENCESTRING交易序列号用作对账用。ADDTYPENUMINT需要扣值类型数量ACCOUNTTYPEINT加值类型2-