統一接口平臺數據模型資料

培訓資料

編寫編寫時間

審核審核時間

文檔版本

文檔修訂記錄

日期版本號描述著者審閱者日期

目錄

第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了。

渠道也分為接入渠道