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

移动网上商城统一接口平台

灰度环境测试指南

目录

移动网上商城统一接口平台 (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得到的报文分析，如果二级码返回结点（）返回0000,则证明查询成功，省份可以根据网状网接口规范查看返回的结果信息。该例子中显示账户总余额有0.00，当前可用余额为0.00，实时话费是791.05，历史欠费为0.00.如果二级码返回结点不返回0000，证明是有问题的，省份可以根据得到的流水号(在响应返回报文中的结点)进行分析，看问题出在哪儿，做具体的修改。

备注:

常见错误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：