统一接口平台

目 录

1 统一接口平台

1.1 1.2 1.3 1.4 1.5

接口平台架构 ......................................... 逻辑架构图 ........................................... 功能模块图 ........................................... 实现方式及流程 ....................................... 功能实现 ............................................. 1.5.1 调度管理 .......................................... 1.5.2 数据封装管理 ...................................... 1.5.3 协议适配管理 ...................................... 1.5.4 接口定义管理 ...................................... 1.5.5 数据项定义管理 .................................... 1.5.6 缓存及预处理 ...................................... 1.5.7 接口安全管理 ..................... 错误!未定义书签。 1.5.8 监控管理 .......................................... 1.5.9 接口日志管理 ......................................

统一接口平台 接口平台架构

浙江移动电子渠道各子业务系统通过统一接口层获取数据，不直接与外部系统接口打交道。统一接口层通过多种方式与外部系统联接、获取数据并向各子业务系统提供XML数据格式包，将外部系统有效地隔离在业务系统之外。第三方业务系统需要请求的外部接口需要在统一接口层注册，并生成配置文件；每次访问都会被有效地记录，实行监管。

电子渠道系统统一接口平台实现构架如下

在炎黄新星统一接口平台中，接口层为电子渠道系统提供接口访问支撑，提供统一的双向访问接口。应用逻辑层通过调用接口层与各外部系统进行交互，向其他系统传递数据并得到反馈。其他系统通过接口层主动访问电子渠道系统，并得到反馈。

逻辑架构图

? 接口调度层主要的功能是根据外部业务系统的服务请求来进行接口调度管理。 ? 数据封装层对接口协议进行适配，以达到接口层灵活的扩展新的外部接口；接口

适配器中会根据配置规则的要求实现对外部接口调用超时以及重发的处理。 ? 协议适配层的功能完成内部协议（外部系统和接口层之间的数据传输协议）到接

口适配器协议的转换。 功能模块图 实现方式及流程

接口主要分为两类：包括主动发起请求方式、被动接收请求方式接口；主动请求类接口主要是电子渠道接口平台向外围系统发起接口请求的，包括与BOSS的接口、银联接口、短信/WAP网关接口、第三方支付系统接口等；被动请求类接口主要是第三方外围系统向电子渠道发送的接口请求，包括业务查询、开户、办理、支付等请求。

接口层作为Client端主动发起服务请求时，要按照接收服务请求方的协议进行数据交互；作为Server端被动接收服务请求时，要承担服务请求端的协议适配功能。

以下以查询类业务为例，说明数据的交互流程。 功能实现 调度管理

接口调度为应用逻辑层提供统一的访问入口，提供应用逻辑层所需要的各种业务接口。应用逻辑层通过webservice远程访问接口层提供的各种功能接口，比如话费查询，业务办理，银联支付等等。

调度管理则根据不同的请求类型，调用相应的后端功能模块或其它系统功能模块处理服务请求。接口平台根据通过web services把调用方法暴露给电子渠道系统应用层供其调用；电子渠道系统应用层和接口层之间的接口就一个，通过传入参数（xml）定义的不同区分不同的业务。 数据封装管理

现有BOSS、短信网关/WAP网关、支付实体等外部系统采用透明/加密方式和电子渠道系统交互数据。需要在接口层中的数据封装层进行统一定义，统一处理。这样设计的原因有以下方面：

? 保持了核心数据的一致性， BOSS等外部对应用层是个“黑盒子”，应用层从

外部系统接受统一格式、统一定义的业务接口数据；

? 接口层能够“理解”第三方系统的接口业务定义，然后统一“翻译”成标准

的业务数据接口供应用层调用，可以使应用模块开发小组更加专注于业务逻辑的开发，提升了开发质量和效率

? 使各业务模块既可以独立支撑不同的接入，又便于模块间的松耦合调用 数据封装层根据请求获取相应的业务转换规则，将从应用逻辑层发送过来数据封装为其他系统能够接收的格式；将从其他系统获得的数据封装成应用逻辑层可处理的格式，并对其中需要统一语义、统一格式的数据进行格式化。 协议适配管理

为屏蔽不同接入方式服务请求所采用的协议差异，协议转换功能支持将各种接入协议转换为统一的服务请求协议。在请求处理结果反馈时，支持将统一的服务请求协议转换成不同接入方式可识别的协议模式。 通讯方式

1. 支持多种实现方式的接口，包括主动发起请求方式、被动接收请求方式。

2. 主动请求主要是电子渠道接口平台向电子渠道外的系统发起的接口请求，包

括与总部BOSS的接口、银联接口、、第三方支付系统接口等。

3. 被动请求主要是电子渠道外围接口向电子渠道发送接口请求，包括业务查询、

办理等。

实现机制

1． J2EE/EJB API调用方式：统一接口平台通过API服务调用方式将接口信息实时同步给第三方业务系统。

2． 消息队列传输方式：统一接口平台通过消息中间件将接口信息通过消息队列传送给第三方业务系统。

3． SOCKET方式：统一接口平台通过Socket方式将接口信息等数据同步给第三方业务系统。

4． Web Service方式：统一接口平台通过WEB SERVICE服务调用方式将接口信息实时地传送给第三方业务系统。

5． URL调用方式：统一接口平台通过调用第三方业务系统URL实现相应接口的业务处理。

6． 文件方式：统一接口平台通过FTP文件方式将接口信息定时同步给第三方业务系统。

协议转换

为屏蔽不同接入方式服务请求所采用的协议差异，协议转换功能支持将各种接入协议转换为统一的服务请求协议。在请求处理结果反馈时，支持将统一的服务请求协议转换成不同接入方式可识别的协议模式。 接口定义管理

接口定义管理帮助管理员通过标准的定义工具来定义和维护接口。通过接口定义管理有效的提高了接口层的灵活性。

应用层接口 查询类接口 ? 话费余额查询 ? 缴费记录查询 ? 历史帐单查询 ? 积分查询 ? 积分消费历史记录 ? 积分生成明细 ? 业务办理接口 受理类接口 ? 积分兑换充值卡 ? SP定制信息查询及取消 ? 呼叫转移设置及取消 ? 国际漫游开通关闭 ? 增值业务受理 ? 充值缴费 ? 充值卡充值 ? 银联卡缴费 ? 其他支付手段缴费 ? 机主报停报开 支付类接口 ? 第三方支付 ? 接触层调用本接口向第三方支付接口进行支付