1、游戏账户安全平台消息接口规范说明1 说明本接口说明游戏账户平台与各游戏中心的消息接口。该消息接口以长连接方式上承载的 XML 类型的封装方式通信。包括的消息有:游戏中心连接请求、游戏中心用户扣费与加值请求等。2 消息封装规范M S G H E A D E RI L M S G B O D YT说明:1. I 为消息间隔标志:rnrn,4BYTE。在连接上,如果持续读到rnrn,则表示新消息的开始。2. L 为消息长度,int 型,占 4BYTE。L 是指后续 MSG HEADER+MSGBODY+4 的总长度。3. T 为消息类型 ID。应答消息类型 ID=请求消息类型 ID+0xFF00;3
2、 接口消息定义序号 请求消息名称 请求类型 ID 应答消息名称 说明1. GAME_LOG_REQ 0x01 GAME_LOG_RES 游戏服务联接账平台请求与应答2. HEAT_BEAT 0x00 心跳消息3. USER_AUTH_REQ 0x02 USER_AUTH_RES 用户验证请求与应答4. USER_ACCOUNT_REQ0x03 USER_AMOUNT_RES 用户账户余额查看请求与应答5. USER_PAY_REQ 0x04 USER_PAY_RES 用户支付请求与应答6. USER_ADD_REQ 0x05 USER_ADD_RES 给用户加值请求与应答4 消息头部定义字段名
3、 字段类型 字段含义 说明MODULEID INT 模块 IDMODULENAME STRING 模块名由账户平台给每个游戏中心分配。MODULEAUTHCODE STRING 模块验证码 由账户平台发送给各游戏中心的单次校验码,在一个连接内有效。初次连接为空。SESSIONCODE STRING 会话 ID 请求与应答的会话 ID 必须一致ERRORFLAG INT 错误标志 0-无错 1-出错ERRORSTRING STRING 错误信息 没有错则为空5 消息体定义5.1 GAME_LOG_REQ字段名 字段类型 字段含义 说明LOGNAME STRING 登录名LOGPWD STRING
4、 密码 MD5 加密后的密文LOGTIME STRING 登录时间 年月日时分,作为 LOGPWD 加密的明钥.LOGINFO STRING 其它登录说明5.2 GAME_LOG_RES字段名 字段类型 字段含义 说明MODULEAUTHCODE STRING 由账户平台返回的连接校验码5.3 HEAT_BEAT心跳消息为空消息体。5.4 USER_AUTH_REQ字段名 字段类型 字段含义 说明USERNAME STRING 用户名USERPWD STRING 用户密码 MD5 加密后的密文。DOMAINID INT 当前登录域 IDDOMAINPWD STRING 当前登录域密码 MD5
5、加密后的密文。5.5 USER_AUTH_RES(需要确认)字段名 字段类型 字段含义 说明USERID INT 用户 IDUSERNAME STRING 用户名USERRIGHTFLAG INT 用户权限标识 1-有权限0-无权限AUTH_INFO STRING 用户验证说明5.6 USER_PAY_REQ字段名 字段类型 字段含义 说明USERID INT 用户 IDDOMAINID INT 区 IDDOMAINPWD STRING 区密码 MD5 加密PAYSEQUENCE STRING 交易序列号 用作对账用。PAYTYPENUM INT 需要扣值类型数量PAYTYPE INT 扣值类
6、型 系统可以处理多种值的扣减。在这PAYNUM INT 扣减数量 里循环增加即可。5.7 USER_PAY_RES字段名 字段类型 字段含义 说明USERID INT 用户 IDDOMAINID INT 区 IDPAYSEQUENCE STRING 交易序列号 用作对账用。PAYTYPENUM INT 需要扣值类型数量PAYTYPE INT 扣值类型PAYRESULT INT 扣减结果BALANCE INT 扣减后余额0- 失败1- 成功5.8 USER_ ACCOUNT _REQ字段名 字段类型 字段含义 说明USERID INT 用户 IDDOMAINID INT 区 IDDOMAINPW
7、D STRING 区密码 MD5 加密5.9 USER_ ACCOUNT _RES字段名 字段类型 字段含义 说明USERID INT 用户 IDDOMAINID INT 区 IDACCOUNTNUM INT 账户类型数量ACCOUNTTYPE INT 账户类型BALANCE INT 账户余额重复使用5.10 USER_ ADD _REQ字段名 字段类型 字段含义 说明USERID INT 用户 IDDOMAINID INT 区 IDDOMAINPWD STRING 区密码 MD5 加密ADDSEQUENCE STRING 交易序列号 用作对账用。ADDTYPENUM INT 账户类型数量ACCOUNTTYPE INT 账户类型ADDNUM INT 账户增加数重复使用5.11 USER_ADD_RES字段名 字段类型 字段含义 说明USERID INT 用户 IDDOMAINID INT 区 IDADDSEQUENCE STRING 交易序列号 用作对账用。ADDTYPENUM INT 需要扣值类型数量ACCOUNTTYPE INT 加值类型ADDRESULT INT 加值结果BALANCE INT 加值后余额2- 失败3- 成功问题:1 游戏中心对于大批量用户加值或减值处理要提交维护管理后台来处理。2 所有的 MD5 加密除了第一次连接请求外,都使用校验码作为明钥。