統(tǒng)一接口能力平臺

接口調(diào)用流程與環(huán)境

1.背景介紹

統(tǒng)一接口能力平臺是一個業(yè)務(wù)集成平臺，它集成了一級客服系統(tǒng)、各

省CRM系統(tǒng)及各省能力平臺的業(yè)務(wù)能力，即接口APL

2.網(wǎng)絡(luò)結(jié)構(gòu)及平臺所處的位置

系統(tǒng)間交互圖

接入渠道普元ESB統(tǒng)一接DCore工程統(tǒng)一接口ESB工程目標(biāo)系統(tǒng)

3.術(shù)語

綁定：指客戶通過自助渠道進行業(yè)務(wù)辦理時，需要先進行第3方帳號

與手機號進行關(guān)聯(lián)，平臺對關(guān)聯(lián)關(guān)系數(shù)據(jù)進行維護。綁定方

式有：手機號+隨機碼、手機號+密碼

憑證：指用戶訪問系統(tǒng)的身份，不同的身份進行不同類別的接口調(diào)用。

憑證分3個級別：一般憑證、隨機碼憑證、服務(wù)密碼憑證。

憑證級別權(quán)限劃分：一般憑證、隨機碼憑證只能用于業(yè)務(wù)查詢

類接口的調(diào)用，服務(wù)密碼憑證用于業(yè)務(wù)辦理類接口調(diào)用

4.接口分類

主要包含2大類接口：認證類、'業(yè)務(wù)類（杳詢類、辦理類）。

由于不同后端系統(tǒng)，認證機制不一樣，所以平臺提供的認證類接口、

業(yè)務(wù)類接口是分系統(tǒng)的。即，認證類與業(yè)務(wù)類接口要配套使用。

如：要使用一級客服的系統(tǒng)的話費查詢接口，則先用一級客服的認證

接口進行認證，而不能用其它系統(tǒng)的認證接口。

目前主要有省端系統(tǒng)、一級客服系統(tǒng)、商城能力開放平臺系統(tǒng)。

省端系統(tǒng)是指各省的CRM及各省能力平臺。

一級客服系統(tǒng)、商城能力開放平臺是集團公司所提供的面向各省業(yè)務(wù)

的系統(tǒng)。

5.業(yè)務(wù)接口調(diào)用要求

自助渠道：調(diào)用業(yè)務(wù)接口前，要求先進行帳號綁定、憑證申請。

帳號綁定只進行一次，憑證申請則需看有效期，如果在有

效期，則后續(xù)的業(yè)務(wù)接口調(diào)用就不用憑證申請了，如果失

效，但還想繼續(xù)做業(yè)務(wù)接口調(diào)用的，需要再次發(fā)起憑證申

請。

人工渠道：調(diào)用業(yè)務(wù)接口前，要求先進行憑證申請。申請后，且在有

效期，則后續(xù)的業(yè)務(wù)接口調(diào)用就不用憑證申請了，如果失

效，但還想繼續(xù)做業(yè)務(wù)接口調(diào)用的，需要再次發(fā)起憑證中

請。

6.接口使用邏輯流程

先看下面的流程圖:

統(tǒng)一接口能力平臺接口使用邏輯流程

接入渠道統(tǒng)一按口能力平臺

1.綁定接口調(diào)用：這一步是針對自助渠道要求的，綁定接口只需調(diào)

用一次，如果成功，平臺會保存綁定數(shù)據(jù)，這樣后續(xù)的業(yè)務(wù)

接口調(diào)用，就不用再調(diào)用綁定接口了。

綁定接口有2種綁定方式：隨機碼方式、服務(wù)密碼方式。

接入渠道在使用時，可根據(jù)自己的業(yè)務(wù)需要進行選擇。

隨機碼方式是指接入渠道先調(diào)用隨機碼生成接口，給用戶手

機下發(fā)一條隨機碼短信，然后用戶從前臺錄入隨機碼，接著

接入渠道在調(diào)用綁定接口時，把隨機碼作為綁定接口的人參

傳過來，校驗通過后綁定成功。

服務(wù)密碼方式是指接入渠道把用戶的服務(wù)密碼作為綁定接口

的入?yún)鬟^來，校驗通過后綁定成功。

2.憑證申請接口：這一步是針對所有接入渠道的。憑證是分級別，

且有有效期，對應(yīng)的會有一般憑證申請接口、隨機碼憑證申

請接口、密碼憑證申請接口。有些系統(tǒng)會把這幾種級別合并

在一個接口當(dāng)中。不同的級別可調(diào)用不同的接口。一般是這

樣劃分的，查詢類接口需要一般憑證，辦理類接口需要服務(wù)

密碼憑證。

3.業(yè)務(wù)接口調(diào)用：前2步做完，就可以進行業(yè)務(wù)接口調(diào)用了。

注意，不是每個業(yè)務(wù)接口調(diào)用都要調(diào)用前2步的接口。

7.開發(fā)流程

1.接到需求

2.需求分析與估算工時

3.需求資源提前申請