统一接口平台数据模型培训讲义

统一接口平台数据模型资料

培训资料

编写编写时间

审核审核时间

文档版本

文档修订记录

日期版本号描述著者审阅者日期

目录

第1章项目介绍.......................................................................2

M统一接口平台.....................................................................2

1.1.1构建统一接口平台目的...............................................................................................................2

1.1.2作用体现.........................................................................................................................................2

1.2整体工作流程.....................................................................3

第2章数据模型.......................................................................3

2.1模型介绍.........................................................................3

2.2接口模块.........................................................................4

2.2./什么是接口.....................................................................................................................................4

2.2.2平台接口介绍.................................................................................................................................4

2.2.3接口参数模块................................................................................................................................4

2.3路由模块.........................................................................5

2.4加密模块.........................................................................5

2.5渠道模块.........................................................................5

2.6协议模块.........................................................................6

第1章项目介绍

1.1统一接口平台

1.1.1构建统一接口平台目的

改变以往系统间多对多的接口模式，建设统一接口平台，时外部系统的接口进行统一的接入管

理，改变以往多对多的复杂映射关系，高效提高接口访问支撑效率；同时，将外部系统有效地隔离

在业务系统之外，有效地记录监管访问行为，有力保障业务系统的安全性。

1.1.2作用体现

•业务系统在符合接口平台要求的前提下，可对接口平台己接入提供的多种接口进行调用，无

需向外部系统重新申请，极大的提高接口的访问效率、对接效率。

•外部系统均在接口平台做统一的接入管理，统一接口平台通过多种方式与外部系统联接、获

取数据并向各子业务系统提供接口输出，将外部系统有效地隔离在业务系统之处。

2

1.2整体工作流程

先了解下接口平台大致的工作流程，并结合流程能更好了解数据模型的一些抽象概念。

图i.i

调用方是指在线内部的一些业务系统（这些系统有很多，暂列出这么多）。

ESB为能力管控平台。（全文会忽略此系统，但要清楚有ESB系统的存在）

统一接口平台就是我们项目系统。

省端系统是指外边系统，也是服务提供方。这些系统不光只有省端了，还有一些其他系统，如:

一级客服、集团商城等。

下图是比较详细的调用图，但全文不以此图讲解。

第2章数据模型

2.1模型介绍

数据模型展示了统一接口平台数据库表结构及表与表之间的关系。通过这个模型，可清晰了解

到各个模坎之间的联系。

数据模型不仅仅是展示数据库表，也有很多设计性概念的东西在里面，这需要一定时间去体会。

本材料会简单阐述这些概念。

数据模型分为5个功能模块。分别是：接口模块（包含接口参数模块）；路由模块；加密模块、

渠道模块、协议模块，各个模块之间相互协作工作，共同完成一次完整请求。

3

2・2接口模块

221什么是接口

这个接口并不是javainterface,而是〜种服务。就以图1.1来说，比如；各省提供了各自的

话我查询服务接口，平台去对接各省端的话费杳询服务，这样平台就能获取到不同归属地手机

号的话费信息。也可以理解为接口平台向省端发出一个http请求，省端根据不同的入参判断接

口平台要使用什么服务，然后将相应的数据响应给平台。

2.2.2平台接口介绍

在统一接口平台数据模型里，接口分为接入接口、转接接口。

接入接口：统一•接口平台提供的抽象服务能力。

平台向在线内部各个系统提供的接口服务，也就是平台提供一些服务接口，供其他系

统调用。

转接接口：落地方业务系统（一级客服、省CRM、终端厂家等）提供的具体服务能力。

是省端提供的一些接口服务，供平台调用。

再看回图1.1,比如内部一些系统调用统一接口平台提供的话费查询接口（全文会忽略

ESB。），用户的话费信息是存储在各个省端服务器上的，所以接口平台会根据手机号的

归属地去调用相应省端的话费查询接口来获取数据，然后响应给调用者。

接入接口与转接接口是相互对应的，而且是1个接入接口会对应多个接入接口（完美

理论上是1:31）。也就是说，就话费查询接口来说，平台对内部系统只提供1个话费查询

接口，而31个省都会提供•个话费查询接口，乜就是平台要转接31份。

2.2.3接口参数模块

接口参数分为入参、出参；

统一接口平台作为接口枢纽，提供接口一去多的映射关系，同理参数也呈现一对多的

映射关系。

上面也介绍过，接口是一种服务，那么我们来举例说明参数映射：调用方要想知道某

手机号本月用了多少话费，那么就必须给平台传递一个手机号，这个就是入参（接入接口

入参），我们暂时用phoneNum这个key来标识手机号，平台会通过这个key取出手机号。

平台要想知道这个手机号的消费情况，就需要调用省端的话费查询服务接口，省端也需要

手机号来杳询相应数据，那么平台就需要将手机号再传给省端系统（转接接口入参），但

是省端并不是用phoneNum这个key而是用serviceNum来取手机号的，那么平台就需要将

phoneNum这个key换成serviceNum,那么phoneNum与serviceNum就要有映射关系。出

参同理。

这只是一个省，那么31个省呢？思考一下。

4

2.3路由模块

路由模块原理很简单，就是调用方给平台传入一个手机号，平台会根据手机号来查询

出该号码的归属省份，进而找到对应的转接接口。

接入接口会关联出当前接入接口使用的是哪个路由策略，进而进行相应路由找到对应

的转接接口。

只有接入接「I是需要路由的，因为接入接IT需要路由出对应的转接接口・而转接接口

是不需要路由的。

2.4加密模块

加密模块，顾名思义就是用于加解密的。加密算法很多，加密方式也很多。各省端提

供接口的加密方法各不统一，有些省份需要将传递的参数加密，并且各省份加密算法还不

一样，有些就不需要加密。

当路由出转接接口时，转接接口会关联出这个接11是否需要加密，用什么方式加密，

然后进行相应的处理。

2.5渠道模块

渠道概念有点抽象。首先介绍业务系统、转接接口、渠道的关系。转接接口归属与某个业务系

统，渠道记录着业务系统的地址，业务系统归属于某个省，一个省可有多个业务系统。

转接接口与业务系统是多对一关系，根务系统与渠道时1”关系。

举例说明1：业务系统就像是•栋大楼，转接接口就像是大楼里边的一个人，渠道就是通往这

栋大楼唯一的路（也可以说是方向）。

举例说明2：接入接口是A点，转接接口是B点，渠道就是A到B之间的线。

也就是说，你有接入接口了，有渠道了，就能找到转接接II了。

渠道也分为接入渠道