中国移动商城统一接口平台灰度环境测试指南

移动网上商城统一接口平台
灰度环境测试指南
目录
移动网上商城统一接口平台 (1)
灰度环境测试指南 (1)
目录 (1)
1.概述 (2)
1.1 背景 (2)
1.2主要内容 (2)
1.3 灰度环境测试地址 (2)
1.4 注意事项 (2)
2.测试指南 (3)
2.1实时话费查询测试指南 (3)
2.2主套餐变更测试指南 (9)
2.2.1普通主套餐变更测试 (9)
2.2.2 4G自选主套餐变更测试 (11)
1.概述
1.1 背景
移动商城已经正式上线对外开放, 为了给各省程序修改后进行复测提供便利,提供一个移动商城统一接口平台的灰度测试环境. 在灰度测试环境中,可以模拟统一接口平台的各个接入渠道(一级wap 渠道编码09, 移动商城渠道编码07, 融合通信渠道编码61等) 向省分生产环境模发送报文, 测试过程中产生成功,失败或者异常的交易, 都不会计算在对省分通报的数据中.
1.2主要内容
对商城生产环境中实时话费查询、主套餐变更两个接口的测试方法进行详细的介绍. 其他的接口和这两类接口的测试方法类似, 字段映射规则参照集团下发的接口规范<<中国移动网状网系统接口规范-移动商城业务分册V1.5.2（下发稿）>>.
1.3 灰度环境测试地址
/i/gray/esbclient.jsp
1.4 注意事项
界面连接的是网状网中心的生产环境以及31省接口的生产环境, 切勿进行压测.
目前由于详单查询接口,涉及到多个凭证的获取, 目前详单接口暂不可用.
如果有其他问题,文档中无法解决的, 可以和商城接口人员进行联系:
2.测试指南
2.1实时话费查询测试指南
(1) 浏览器中输入测试地址
推荐使用火狐或者chrome浏览器
输入生产环境测试地址/i/gray/esbclient.jsp结果见图1：
图1
(2)点击“点击登录”结果见图2：
备注: 这异步登录会调用省分统一认证接口, 获取一个身份凭证, 用于后续的接口交易. 可能出现的问题: 账户锁定, 密码错误, 提示系统错误等, 首先需要确认号码是否有效, 其次确认省分统一认证的S模块接口是否运行正常, 如果皆正常且无法进一步定位具体问题, 可以在统一认证联调接入群或者在移动商城统一接口平台和统一认证的同事确认一下.
图2
(3)在“手机号登录”选项卡下对应输入要测试的手机号和服务密码以及验证码，见图3
图3
(4)当验证码输入框右边缘出现“绿色对勾”标识（表示输入的验证码正确）时，点击“登录”按钮，结果见图4
图4
(5)然后点击“请跳转到测试界面”超链接，结果见图5
图5
(6) 在对应的服务选项下的服务名称中选择要查的服务名称，此时选择“实时话费查询”，在参数设置标题下的渠道编码、手机号、身份凭证号会默认显示。

默认的渠道为移动商城：0702，如需更改，请根据渠道编码进行更改。

渠道编码表如下所示:
0701-移动商城销售子系统
0702-移动商城自服务子系统
0703-移动商城能力开放平台
0900-一级WAP营业厅
6900-手机营业厅
6100-融合通信
6200-微信营业厅
6300-10085电话
然后点击“调用”，结果如图6：
图6
(7) 在图6中可以清楚的看到发送报文和响应返回，响应返回是按照网状网规范返回的结
构报文，详细响应返回如图7：
图7
(8) 分析省分返回的接口报文
根据图7得到的报文分析，如果二级码返回结点（<RspCode></RspCode>）返回0000,则证明查询成功，省份可以根据网状网接口规范查看返回的结果信息。

该例子中显示账户总余额有0.00，当前可用余额为0.00，实时话费是791.05，历史欠费为0.00.如果二级码返回结点不返回0000，证明是有问题的，省份可以根据得到的流水号(在响应返回报文中的<TRANSIDO></ TRANSIDO >结点)进行分析，看问题出在哪儿，做具体的修改。

备注:
常见错误1:
如果参数遗漏, 或者参数不符合网状网接口规范, 将导致返回错误校验信息.
比如如上图所示结束时间为NULL, 那么就会返回
根据接口规范
约束为1, 表示必填字段, 从错误描述信息可以看出:
InputError:9701:cvc-pattern-valid: Value '' is not facet-valid with respect to pattern '\d{4}((0[1-9])|(1[0|1|2]))(([0|1|2]\d)|(3[0|1]))' for type 'null'.cvc-type.3.1.3: The value '' of element 'StartEnd' is not valid.:null
元素的值: 'StartEnd' 无效, 传入的是一个空值.
常见错误2:
Exception:9799: Read timed out:UMMP2015010100122238278519
这个错误是统一接口平台通过网状网中心调用省分接口超时.
TransIDO的规则是渠道ID+ UMMP2015010100122238278519
比如: 渠道ID是0701, 那么TransIDO 就是:
0701UMMP2015010100122238278519, 省分可以根据这个值进行排错.
2.2主套餐变更测试指南
由于变更的主套餐分普通套餐和4G组合套餐两种情形，现对这两种不同的情形进行说明.
2.2.1普通主套餐变更测试
主套餐变更涉及到三个接口:
根据主套餐变更的流程, 第一步查询用户当前的套餐; 第二步调用主套餐变更内容查询,获取变更新套餐后需要新加哪些产品,删除哪些产品; 第三步根据第二步响应报文的结果,选择需要新加的产品作为第三步主套餐变更的入参,进行套餐变更.具体的实现细节可以参考<<中国移动网状网系统接口规范-移动商城业务分册V1.5.2（下发稿）>>的相关章节: 6.14.2 业务流程(page:65)
在服务名称中选择“主套餐变更内容查询”选项，如图9：
图9
在“参数设置”栏中对应的“主套餐ID”输入框中输入要变更的主套餐id,点击“调用”结果如图10：
图10
如果变更内容查询接口成功, 那么继续在服务名称中选择“主套餐变更”，将图10中的响应成功的报文中的NewProdInfo 节点的内容(包含此节点) 粘贴到“主套餐变更内容查询结果”中，再在新主套餐标识输入框中输入要变更的主套餐ID，如图12：
图12
（3）然后点击“调用”，就会在响应返回中得到响应的变更结果，如果二级码返回0000，就是变更成功，如果返回其他的二级码，则需要省份根据二级码规范和网状网接口规范进行问题分析和查找。

2.2.2 4G自选主套餐变更测试
4G自选套餐目前集团选择8个试点省进行测试, 为避免业务测试周期过长, 导致接口程序反复变更, 重复上线, 需要省分在接口上线当晚, 在生产环境中对修改的接口进行验证.
目前试点8个省,4G组合套餐的变更, 直接调用主套餐变更接口, 具体步骤为: 在服务名称中选择“主套餐变更”选项，在新主套餐标识中输入要变更的4G自选套餐组合id, 主套餐变更内容查询结果输入框中不需要输入内容。

如图14所示: 备注: 4G自选套餐组合id格式各省有差异，例如北京的为：111002004041|111002004040|111002002202，内蒙的为：40000519+40040006+40040032格式, 河南则是任意组合对应唯一一个不同的产品ID,类似于普通主套餐的受理流程）.
图14
点击“调用”，结果如图15：
图15
根据图15显示此号码已经订购了此4G自选套餐，如果二级码返回0000，则表示订购成功。

注意事项:
在模拟测试时候, 关于套餐变更,或者业务办理接口需要的产品ID, 套餐ID等信息, 需要省分接口根据渠道的不同选择正确的产品ID进行测试.
1)移动商城使用的产品ID是通过商城上架系统提供的.
2)一级WAP使用的产品ID是通过电渠交流平台上报的物料
3)10085 融合通信是省分提供的.。