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

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

1.背景介紹

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

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

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

系統(tǒng)間交互圖

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

3.術(shù)語(yǔ)

綁定：指客戶通過(guò)自助渠道進(jìn)行業(yè)務(wù)辦理時(shí)，需要先進(jìn)行第3方帳號(hào)

與手機(jī)號(hào)進(jìn)行關(guān)聯(lián)，平臺(tái)對(duì)關(guān)聯(lián)關(guān)系數(shù)據(jù)進(jìn)行維護(hù)。綁定方

式有：手機(jī)號(hào)+隨機(jī)碼、手機(jī)號(hào)+密碼

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

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

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

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

4.接口分類

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

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

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

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

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

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

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

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

的系統(tǒng)。

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

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

帳號(hào)綁定只進(jìn)行一次，憑證申請(qǐng)則需看有效期，如果在有

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

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

請(qǐng)。

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

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

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

請(qǐng)。

6.接口使用邏輯流程

先看下面的流程圖:

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

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

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

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

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

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

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

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

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

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

傳過(guò)來(lái)，校驗(yàn)通過(guò)后綁定成功。

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

的入?yún)鬟^(guò)來(lái)，校驗(yàn)通過(guò)后綁定成功。

2.憑證申請(qǐng)接口：這一步是針對(duì)所有接入渠道的。憑證是分級(jí)別，

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

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

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

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

密碼憑證。

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

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

7.開(kāi)發(fā)流程

1.接到需求

2.需求分析與估算工時(shí)

3.需求資源提前申請(qǐng)