能力开放平台

中国移动通信有限公司部门（通知）
业通 [2013] 231 号
关于移动商城近期建设工作安排的通知
各省、自治区、直辖市公司，终端公司：
根据《关于统一门户移动商城入驻工作部署的通知》（市通[2013] 373 号）的要求，总部移动商城将在今年底完成首批试点公司（江苏、福建、河北、黑龙江、江西、青海、终端公司等）入驻并启动试运行。

移动商城采用“总部统一建设平台、分省入驻开店销售”的建设模式，由总部和各省共同协作，是公司IT支撑集中化的重要举措。

为满足省公司入驻需要，移动商城采用能力开放平台和统一接口平台两种方式进行IT对接，其中能力开放平台采用公网接入方式和API接口方式，主要支持卡号销售、合约机销售和裸机销售等业务场景；统一接口平台采用IP承载网接入和网状网T模块接口方式，主要支持业务查询、业务办理和充值缴费等业务场景。

根据整体项目计划，总部已经组织完成了业务需求分析、技术方案制订等工作，目前正在进行一级系统的软件开发，拟定于11月份启动两级系统联调测试工作，12月份启动试点公司入驻演练工作，现将省公司和专业公司系统建设工作的有关事项通知如下：
一、业务上架
各省公司、专业公司根据自身业务发展需要确定商城承载业务范围，总部将根据各公司需求上报情况提前制定相关业务流程和业务上架模板，各公司可以利用商城运营后台自行配置业务上架。

请各试点公司以今年底上线为目标，明确第一批业务产品清单（含资费套餐、数据业务、终端合约、充值缴费等，终端合约可先预报合约类型、档次等），10月20日前按照《拟一期上架业务清单》（详见附件一）格式要求填写并上报。

总部后续将下发商城后台使用手册并组织培训，请各省提前明确本省业务上下架管理部门和责任人（每省可设全省发布人、审核人各一名+地市发布人、审核人各一名/每地市），同期上报总部。

二、能力开放平台对接
为适应电子商务的行业发展趋势，移动商城的产品销售平台将依托能力开放平台构建，一方面商户自有系统可以通过能力开放平台获取和更新商城内部的商户、订单、商品、营销等数据，另一方面商户自有系统通过能力开放平台为商城提供购买资格校验、订单通知接收等服务。

目前总部已组织编制完成了《能力开放平台接口规范V1.0》（详见附件二），以及《移动商城商户系统与能力开放平台对接指南》（详见附件三），拟定于11月初提供公开测试环境。

请试点省公司和终端公司根据年底业务上架需要，结合自身实际情况确定系统接入方案，并于10月25日前提交接入申请，总部审
核通过后下发接入所需要的APPKEY等凭据。

申请接入通过的省公司可根据本省系统改造进度自行安排测试计划，但应确保11月底前完成，以满足12月入驻演练的需要。

未纳入试点范围的省公司应提前学习相关技术文档，做好技术方案储备和系统配套改造工作，具体接入的时间安排总部将另文通知。

三、统一接口平台对接
移动商城的自助服务平台将通过统一接口平台、一级BOSS网状网与各省CRM系统互通，完成业务查询、业务办理、充值缴费等业务。

根据《关于下发<中国移动移动商城省级系统改造方案>的通知》（业通[2013]229号）的要求，请6个试点省力争在2013年10月底完成改造具备联调条件，其余省于2013年11月底改造完毕具备联调条件。

总部将于11月启动6个试点省的联调测试，12月启动其余25省的联调测试，年底前完成业务上线。

四、其他事项
1、请各省公司以及终端公司针对业务上架、能力开放平台对接、统一接口平台对接等三项工作分别指定专门的接口人，并于10月20日前将接口人信息按照附件表格（详见附件四）要求，通过邮件方式发给总部相关联系人。

2、根据“总部收单、各省执行”的职责分工原则，移动商城负责接收用户订单并流转至各省公司进行订单处理工作，总部后续将下发商城
运营相关规范，请各试点省根据本省实际情况，提前梳理省内订单处理业务流程，并做好运营团队的组建工作。

业务需求内容
能力开放平台是中国移动网上商城和商户自有系统进行IT对接的一个桥梁。

一方面商户自有系统可以通过能力开放平台获取和变更移动商城内部的商户、订单、商品、营销等数据，另一方面商户自有系统通过能力开放平台为商城提供购买资格校验、订单通知接收等服务。

图1-1 能力开放平台的位置
本规范对能力开放平台与商户自有系统交互接口提出规定，能力开放平台内部和商户自有系统共同使用。

术语
全称说明
APPKEY 应用标识用于标识唯一的商户自有系统。

SECRET 应用秘钥用于应用请求能力开放平台接口参数加密的
秘钥。

加入能力开放平台
在商户开始开发自己的应用之前，需要先创建一个用于调用商城能力开放平台API的应用，能力开放平台会提供应用创建管理的界面，应用创建后会生成appkey和secret秘钥，用于接口请求和签名认证。

详细流程见下图：
图4-1 加入能力开放平台
流程说明：
1、首先需要在移动商城完成入驻手续成为商户。

2、使用商户账户登录能力开放平台web界面系统，填写必要信息后，创建属于自己商户的
应用，应用创建后会生成只属于该应用的APPKEY和秘钥SECRET。

创建应用时需要商户在能力开放平台web界面系统内完成资格校验接口和通知接口的添加。

校验和通知接口用于商城经由能力开放平台请求商户系统，发送订单生成通知、资格校验等请求。

3、应用测试，应用申请成功后即可开始开发测试，此时的应用只有调用测试环境接口的权
限。

4、应用上线，测试完成后根据测试报告集团审核通过后可以部署到正式环境上线。

授权机制
授权流程
IP进行鉴权
并进行认证
图5-1 商户请求能力开放平台授权机制过程
【流程说明】
1、商户向移动商城能力开放平台接口发送请求；
2、开放平台服务器对请求IP进行鉴权；
3、服务器IP鉴权失败，返回错误信息；
4、服务器IP鉴权成功后，接收请求签名参数；
5、对接收到的签名参数进行比较验证，并对商户身份进行认证；
6、签名认证失败，直接返回错误信息；
7、签名认证成功，接收请求报文并响应；
8、响应后返回接口请求的应答报文；
IP进行鉴权
并进行认证
图5-2 反向校验和通知授权机制过程
【流程说明】
1、能力开放平台向商户自有系统发送请求；
2、商户系统对请求IP进行鉴权；
3、服务器IP鉴权失败，返回错误信息；
4、服务器IP鉴权成功后，接收请求签名参数；
5、对接收到的签名参数进行比较验证；
6、签名认证失败，直接返回错误信息；
7、签名认证成功，接收请求报文并响应；
8、响应后返回接口请求的应答报文；
5.1服务器间鉴权
简介与实现
能力开放平台和商户自有系统服务器之间采用双向的IP白名单认证，各自系统都要提
供服务器IP给对方加入白名单，并在访问时在网络或者程序端进行验证。

认证实现
在IP认证实现中有两种可选方案：
1、在系统中配置IP分组认证表，IP认证模块根据IP分组中目的地址，端口号等信息，
对来往的IP信息进行过滤，允许或者禁止某些IP地址的访问。

2、在服务器端，通过防火墙来进行IP认证的过滤，对不满足的用户IP的请求进行阻
止。

接口说明
订单类接口
获取订单列表
接口描述：获取订单ID列表功能
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS GET
应答报文格式：JSON
获取单笔订单详情
接口描述：获取单笔订单详情
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS GET
应答报文格式：JSON
获取订单当前状态信息
接口描述：根据订单ID获取订单当前状态信息。

接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS GET
应答报文格式：JSON
修改订单状态
接口描述：修改订单状态
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
获取订单状态变更流水信息
接口描述：根据订单ID获取订单的状态变更流水信息接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS GET
应答报文格式：JSON
码号购买资格校验
接口描述：码号购买资格校验接口
接口地址：商户自有系统提供的资格校验接口
接口提供方：商户自有系统
请求发起方：商城能力开放平台
接口版本号：1.0
调用方式：HTTPS GET
应答报文格式：JSON
新用户合约机购买资格校验
接口描述：码号购买资格校验接口
接口地址：商户自有系统提供的资格校验接口
接口提供方：商户自有系统
请求发起方：商城能力开放平台
接口版本号：1.0
调用方式：HTTPS GET
应答报文格式：JSON
老用户合约机购买资格校验
接口描述：码号购买资格校验接口
接口地址：商户自有系统提供的资格校验接口
接口提供方：商户自有系统
请求发起方：商城能力开放平台
接口版本号：1.0
调用方式：HTTPS GET
应答报文格式：JSON
订单生成通知
接口描述：用户支付后，通知商户自有系统订单生成接口地址：商户自有系统提供的通知接收接口
接口提供方：商户自有系统
请求发起方：商城能力开放平台
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
订单状态通知
接口描述：撤单通知
接口地址：商户自有系统提供的通知接收接口
接口提供方：商户自有系统
请求发起方：商城能力开放平台
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
上报物流单号
接口描述：上报商品的物流单号
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
获取物流信息
接口描述：根据订单标识查询物流信息接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS GET
应答报文格式：JSON
获取用户身份证图片
接口描述：获取用户身份证图片
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS GET
应答报文格式：JSON
添加套餐
接口描述：添加单个套餐接口
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
添加号码
接口描述：添加单个号码接口
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
添加合约
接口描述：添加单个合约接口
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
添加合约档（购机送话费合约档）
接口描述：添加单个合约档(购机送话费合约档)接口
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
添加合约档（充值送购机款+送话费合约档）
接口描述：添加单个合约档(充值送购机款+送话费合约档)接口
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
添加合约档和终端对应关系
接口描述：添加合约档和终端对应关系接口接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
接口描述：添加终端接口
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
添加终端SKU
接口描述：添加终端SKU接口
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
添加增值业务
接口描述：添加增值业务接口
接口地址：
接口提供方：商城能力开放平台
请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
删除合约
接口描述：删除合约接口
接口地址：
接口提供方：商城能力开放平台请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
删除合约档
接口描述：删除合约档接口
接口地址：
接口提供方：商城能力开放平台请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS POST
应答报文格式：JSON
获取产品列表
接口描述：获取产品列表
接口地址：
接口提供方：商城能力开放平台请求发起方：商户自有系统
接口版本号：1.0
调用方式：HTTPS GET
应答报文格式：JSON。