MM基地接口文档讲述.doc

游戏核心平台接口说明 文档作者史登明建立日期2015年3月31日所属项目游戏核心平台 一、接口概述 1.1、总体流程 整个接口的使用将涉及到三个对象与两个流程（如图 1.1.1）。三个对象：1、MM服务器，用于获取证书与计费的服务器，不可控服务器。2、交互者，从核心服务器获取短信内容与xml数据，短信用于发送给固定号码，xml用于向MM服务器请求计费与证书。3、核心服务器，创建用于发送的短信内容与向MM服务器请求计费与证书的xml数据。两个流程：1、计费流程。这个流程主要涉及核心服务器的两个接口：billing，pay。及MM服务器的请求计费接口。2、CA证书流程。这个流程主要涉及核心服务器的三个接口：getSMS、getCAquest、udpateCA。及手机发送短信、MM平台的请求证书接口。 图 1.1.1 接口与服务器的交互 1.2、计费流程 两个流程中先从计费流程（如图1.2.1）开始： 通过billing接口请求数据，返回数据（json格式）中判断ret值，如果为-1则走证书流程，证书流程结束后再继续走计费流程。如果为0则直接将数据中的billingdata（Base64解密）通过Post方式提交到MM服务器接口（:80/trusted4）获取定单数据（xml格式）。 2、从MM服务器返回的定单数据（xml格式）中提取SeesionID节点值、CheckID节点值、DynamicQuest节点值（仅Base64加密）、CheckCode节点值、EnMethod节点值（仅Base64加密）作为参数提交到pay接口，返回数据（json格式）中提取confirmdata（Base64解密）后通过Post方式提交到MM服务器接口（:80/trusted4）确认支付。 注意：整个流程中所使用的billing_id要相同，流程结束后再开始则billing_id要不同。 图 1.2.1 计费流程 1.3、证书流程 当证书不存时则走证书流程： 通过getSMS接口获取数据，从返回数据（json格式）中提取sms（Base64解密）通过短信方式发送 短信发送成功后通过getCAquest接口获取数据，从返回数据（json格式）中提取caquest（Base64解密）通过Post方式提交到MM服务器接口 （:80/mmwlan/applySecCertForAPPThird） 获取证书数据。 3、从证书数据（xml格式）中提取randNum节点值（Base64加密），cert节点值（Base64加密）提交到updateCA接口更新证书，从返回数据中提取的ret为0则更新成功。 注意：整个流程中所使用的ca_id要相同，流程结束后再开始则ca_id要不同。 图 1.3.1 证书流程 核心服务器接口详细说明 2.1 billing接口 函数/接口名称：4:9891/mmscn/billing所属类/单元：计费流程功能说明：用于向MM平台获取游戏订单（同时支持POST,GET方式）输入： 参数名说明类型备注/默认值 billing_id业务流水号string唯一的流水号，用于整个过程product_id产品IDint提交的那个APK文件的产品IDchannel_id渠道IDint提交的那个APK文件的产品IDpaycode计费道具代码intimsiIMSIint手机上的IMSI号imeiIMEIint手机上的IMEI号userdata用户自定义参数string可以自定义sdk_version安卓系统版本号string可以虚拟生成model安卓手机型号string可以虚拟生成subsnumb商品个数int默认为1输出：返回结果说明类型备注/默认值 billing_id业务流水号string唯一的流水号，用于整个过程 ret 返回值 string0：正常 -1：证书不存在，重新走获取证书流程 -999：计费失败，该业务不可用 billingdata计费请求数据string核心服务器返回的计费请求数据，由交互者转发给MM平台（Base64编码，XML格式）示例：参数：billing_id=da7203b8-865a-4f41-bafc-37784b92ecc0product_id=3099119channel_id=3003991773paycode=30000884013805imsi=460028505164112imei=358059046796540userdata=testsdk_version=4.4.2model