能力开放平台Word文件下载.docx

能力开放平台Word文件下载.docx

《能力开放平台Word文件下载.docx》由会员分享，可在线阅读，更多相关《能力开放平台Word文件下载.docx（14页珍藏版）》请在冰点文库上搜索。

二、能力开放平台对接

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

目前总部已组织编制完成了《能力开放平台接口规范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、应用上线，测试完成后根据测试报告集团审核通过后可以部署到正式环境上线。

授权机制

授权流程

图5-1商户请求能力开放平台授权机制过程

【流程说明】

1、商户向移动商城能力开放平台接口发送请求；

2、开放平台服务器对请求IP进行鉴权；

3、服务器IP鉴权失败，返回错误信息；

4、服务器IP鉴权成功后，接收请求签名参数；

5、对接收到的签名参数进行比较验证，并对商户身份进行认证；

6、签名认证失败，直接返回错误信息；

7、签名认证成功，接收请求报文并响应；

8、响应后返回接口请求的应答报文；

图5-2反向校验和通知授权机制过程

1、能力开放平台向商户自有系统发送请求；

2、商户系统对请求IP进行鉴权；

5、对接收到的签名参数进行比较验证；

5.1服务器间鉴权

简介与实现

能力开放平台和商户自有系统服务器之间采用双向的IP白名单认证，各自系统都要提供服务器IP给对方加入白名单，并在访问时在网络或者程序端进行验证。

认证实现

在IP认证实现中有两种可选方案：

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

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

接口说明

订单类接口

获取订单列表

接口描述：

获取订单ID列表功能

接口地址：

接口提供方：

商城能力开放平台

请求发起方：

商户自有系统

接口版本号：

1.0

调用方式：

HTTPSGET

应答报文格式：

JSON

获取单笔订单详情

获取订单当前状态信息

根据订单ID获取订单当前状态信息。

修改订单状态

HTTPSPOST

获取订单状态变更流水信息

根据订单ID获取订单的状态变更流水信息

码号购买资格校验

码号购买资格校验接口

商户自有系统提供的资格校验接口

新用户合约机购买资格校验

老用户合约机购买资格校验

订单生成通知

用户支付后，通知商户自有系统订单生成

商户自有系统提供的通知接收接口

订单状态通知

撤单通知

商户自有系统

上报物流单号

上报商品的物流单号

获取物流信息

根据订单标识查询物流信息

获取用户身份证图片

添加套餐

添加单个套餐接口

添加号码

添加单个号码接口

添加合约

添加单个合约接口

添加合约档（购机送话费合约档）

添加单个合约档（购机送话费合约档）接口

添加合约档（充值送购机款+送话费合约档）

添加单个合约档（充值送购机款+送话费合约档）接口

添加合约档和终端对应关系

添加合约档和终端对应关系接口

添加终端接口

添加终端SKU

添加终端SKU接口

添加增值业务

添加增值业务接口

删除合约

删除合约接口

删除合约档

删除合约档接口

获取产品列表