NG1-BASS2.0規(guī)范培訓(xùn)-外部接口分冊

1、中國移動(dòng)省級中國移動(dòng)省級NG1-BASSNG1-BASS技術(shù)規(guī)范技術(shù)規(guī)范外部接口分冊外部接口分冊2022年4月21日星期四目錄目錄1 1、總體說明、總體說明3 3、互動(dòng)接口、互動(dòng)接口2 2、數(shù)據(jù)源接口、數(shù)據(jù)源接口4 4、功能接口、功能接口接口規(guī)范目的接口規(guī)范目的123減少省級經(jīng)營分析系統(tǒng)與源系統(tǒng)之間的相互影響，保障生產(chǎn)系統(tǒng)的穩(wěn)定安全降低省級經(jīng)營分析系統(tǒng)和源系統(tǒng)間數(shù)據(jù)接口的建設(shè)風(fēng)險(xiǎn)和難度，保障數(shù)據(jù)接口的建設(shè)進(jìn)度統(tǒng)一規(guī)范省級經(jīng)營分析系統(tǒng)和源系統(tǒng)之間的連接關(guān)系和接口特性，規(guī)范各數(shù)據(jù)單元的接口格式4采用數(shù)據(jù)封裝機(jī)制，統(tǒng)一規(guī)范省級經(jīng)營分析系統(tǒng)向各外部系統(tǒng)提供信息服務(wù)的標(biāo)準(zhǔn)和接口內(nèi)容 接口規(guī)范原則接口規(guī)范

2、原則在滿足業(yè)務(wù)需求的前提下，使接口數(shù)據(jù)量最少，最大限度地減輕數(shù)據(jù)提供方壓力 保證省級經(jīng)營分析系統(tǒng)與外部系統(tǒng)數(shù)據(jù)一致性 具有可靠完善的接口數(shù)據(jù)傳輸與錯(cuò)誤處理機(jī)制 互動(dòng)接口應(yīng)符合開放系統(tǒng)的標(biāo)準(zhǔn)協(xié)議 應(yīng)具備完整性、規(guī)范性、開放性和靈活性互動(dòng)接口應(yīng)能夠平滑地?cái)U(kuò)充 互動(dòng)接口連接必須具有安全控制機(jī)制 接口定義遵循易理解、易使用、易交流、易擴(kuò)展的原則 擴(kuò)展原則：擴(kuò)展原則：由數(shù)據(jù)源傳送方或數(shù)據(jù)源接收方發(fā)起的接口擴(kuò)展，都必須采用現(xiàn)有的傳輸協(xié)議與模式，并與現(xiàn)有接口編碼規(guī)則和命名規(guī)則保持一致 編制原則：編制原則：接口定位接口定位接口分類接口分類 省級經(jīng)營分析系統(tǒng)與外部系統(tǒng)的接口包括以下三類：數(shù)據(jù)源接口：是省級經(jīng)營分

3、析系統(tǒng)從外部系統(tǒng)獲取數(shù)據(jù)的接口互動(dòng)接口：是省級經(jīng)營分析系統(tǒng)為外部系統(tǒng)提供數(shù)據(jù)信息的接口功能接口：主要包括省級經(jīng)營分析系統(tǒng)與4A安全平臺接口、信息推送接口目錄目錄1 1、總體說明、總體說明3 3、互動(dòng)接口、互動(dòng)接口2 2、數(shù)據(jù)源接口、數(shù)據(jù)源接口4 4、功能接口、功能接口接口數(shù)據(jù)來源接口數(shù)據(jù)來源 直接從省級業(yè)務(wù)支撐系統(tǒng)獲取相關(guān)數(shù)據(jù)，如省級NG1-BOSS、NG1-CRM；直接從省級外部數(shù)據(jù)源系統(tǒng)，如：網(wǎng)管系統(tǒng)、彩鈴平臺、DSMP平臺、OTA平臺、WAP網(wǎng)關(guān)、網(wǎng)絡(luò)信令采集子系統(tǒng)、VGOP平臺、ERP/MIS系統(tǒng)等獲取相關(guān)數(shù)據(jù)；間接通過省級VGOP系統(tǒng)獲取一類業(yè)務(wù)數(shù)據(jù)：中央音樂平臺/無線音樂平臺、手機(jī)

4、報(bào)平臺、飛信平臺、號薄管家平臺、DM平臺、手機(jī)電視平臺、12580綜合信息平臺等的相關(guān)數(shù)據(jù)。間接通過省級VGOP系統(tǒng)獲取二類業(yè)務(wù)數(shù)據(jù)間接通過一級經(jīng)營分析系統(tǒng)獲取：新業(yè)務(wù)營銷體驗(yàn)平臺、行業(yè)應(yīng)用終端監(jiān)控平臺的相關(guān)數(shù)據(jù)。接口編碼原則接口編碼原則 接口單元類別名稱接口單元類別名稱類別代碼字冠類別代碼字冠接口單元類別名稱接口單元類別名稱類別代碼字冠類別代碼字冠客戶管理01客戶服務(wù)02網(wǎng)絡(luò)信令接口94成員管理03OTA平臺接口95資源管理04中央業(yè)務(wù)類96計(jì)費(fèi)帳務(wù)05網(wǎng)管接口97結(jié)算06彩鈴98營銷與市場調(diào)查07DSMP99參數(shù)配置與計(jì)算原則08接口單元接口單元的編碼的編碼單元類別代碼單元類別代碼 二位數(shù)

5、字二位數(shù)字序列號序列號三位數(shù)值三位數(shù)值各接口單元的編碼規(guī)則各接口單元的編碼規(guī)則是：是： 9696中央業(yè)務(wù)類接口單元中央業(yè)務(wù)類接口單元p增加了省級VGOP作為源系統(tǒng)的相關(guān)接口，例如飛信、手機(jī)報(bào)、號薄管家平臺、終端管理平臺、手機(jī)電視平臺、12580平臺、139郵箱平臺、無線音樂平臺的行為數(shù)據(jù)、維表數(shù)據(jù)和指標(biāo)數(shù)據(jù)都從省級VGOP獲??；但訂購關(guān)系類數(shù)據(jù)以NG1-BOSS2.0為準(zhǔn)，從NG1-BOSS2.0獲取訂購關(guān)系數(shù)據(jù)。關(guān)于彩鈴平臺接口數(shù)據(jù)，在省級VGOP未投入使用前，仍然從彩鈴平臺獲取；在省級VGOP投入使用后，彩鈴平臺的數(shù)據(jù)從省級VGOP獲取。關(guān)于新業(yè)務(wù)體驗(yàn)營銷平臺和行業(yè)應(yīng)用終端平臺的接口數(shù)據(jù)還

6、是從中央業(yè)務(wù)平臺獲取。停止了手機(jī)支付接口。9292財(cái)務(wù)類接口單元財(cái)務(wù)類接口單元p本次規(guī)范新增財(cái)務(wù)類接口。具體包括：廣告成本、宣傳成本、通信網(wǎng)運(yùn)營成本、營銷機(jī)構(gòu)成本、銷售費(fèi)用、管理費(fèi)用六個(gè)接口。9494網(wǎng)絡(luò)信令接口單元網(wǎng)絡(luò)信令接口單元p停止了9400194008接口；對原有的94009 A接口做了增加和修訂，同時(shí)新增了94010 Gb信令接口。0101客戶管理接口單元客戶管理接口單元p修改的接口有：01001、01002、01003、01007、01028等；新增接口：01035等；p停止接口：01013、01015、01019、01034等。0202客戶服務(wù)接口單元客戶服務(wù)接口單元p對數(shù)據(jù)源分

7、類做了修改，部分接口單元的說明和字段做了修訂，其中修改的接口有：02001、02002等；對“01002集團(tuán)客戶”接口主要根據(jù)中國移動(dòng)省級NG1-BASS務(wù)規(guī)范集團(tuán)客戶分冊2.0.0進(jìn)行了增加和修訂。新增客戶服務(wù)反饋類接口：02028、02029、02030等。0303員工接口單元員工接口單元p新增的接口：03030-03040等渠道類數(shù)據(jù)源接口0404資源管理類接口單元資源管理類接口單元p主要對04014和01018根據(jù)TD內(nèi)容做了修改，并停止了中繼群、數(shù)據(jù)服務(wù)網(wǎng)關(guān)、短信中心、MISC、SSP、呼叫中心等17個(gè)接口。0505計(jì)費(fèi)帳務(wù)接口單元計(jì)費(fèi)帳務(wù)接口單元p新增05043、05044、050

8、45、05046接口；修訂了05001、05002、05006、05009、05021、05022接口；修訂部分主要增加了對TD業(yè)務(wù)的支撐。0606結(jié)算接口單元結(jié)算接口單元p修訂了06005、06006、06007、06008、06009等接口，新增06024多媒體彩鈴結(jié)算清單、06025 TD終端租機(jī)業(yè)務(wù)結(jié)算、06026跨省集團(tuán)短信結(jié)算、06027省際網(wǎng)間長途結(jié)算接口。07-07-營銷與市場調(diào)查接口單元營銷與市場調(diào)查接口單元p停止了廣告類的接口；新增了營銷反饋類接口。08-08-參數(shù)配置與計(jì)算原則接口單元參數(shù)配置與計(jì)算原則接口單元p停止了08113、08114接口；新增08115用戶關(guān)系類型

9、、08116俱樂部類型、08117客戶與用戶關(guān)系類型接口。目錄目錄1 1、總體說明、總體說明3 3、互動(dòng)接口、互動(dòng)接口2 2、數(shù)據(jù)源接口、數(shù)據(jù)源接口4 4、功能接口、功能接口互動(dòng)接口總表服務(wù)名稱服務(wù)名稱數(shù)據(jù)集數(shù)據(jù)集接口單元說明接口單元說明信息交互方式信息交互方式分類分類名稱名稱營銷服務(wù)互動(dòng)服務(wù)營銷互動(dòng)營銷活動(dòng)配置對一個(gè)具體的營銷與服務(wù)活動(dòng)進(jìn)行概括描述的接口。發(fā)布訂閱方式營銷活動(dòng)目標(biāo)客戶規(guī)則指營銷活動(dòng)中需要選擇的目標(biāo)客戶群過濾的規(guī)則信息。發(fā)布訂閱方式營銷活動(dòng)目標(biāo)客戶指營銷活動(dòng)所選擇的營銷目標(biāo)客戶群的信息。發(fā)布訂閱方式活動(dòng)觸發(fā)規(guī)則用于全程精確營銷信令實(shí)時(shí)匹配的各種參數(shù)規(guī)則接口。發(fā)布訂閱方式活動(dòng)執(zhí)行

10、區(qū)域指營銷活動(dòng)執(zhí)行所覆蓋的區(qū)域信息。發(fā)布訂閱方式資費(fèi)產(chǎn)品推薦互動(dòng)資費(fèi)產(chǎn)品推薦通過客戶細(xì)分、資費(fèi)預(yù)演等專題分析，形成資費(fèi)產(chǎn)品推薦信息。發(fā)布訂閱方式客戶關(guān)懷互動(dòng)客戶挽留名單通過數(shù)據(jù)挖掘方法預(yù)測可能流失的客戶，形成客戶挽留名單信息。發(fā)布訂閱方式客戶關(guān)懷信息通過客戶細(xì)分模型等數(shù)據(jù)挖掘方法，對客戶群體進(jìn)行細(xì)分。發(fā)布訂閱方式策反互動(dòng)策反方案信息通過分析潛在客戶的消費(fèi)行為、消費(fèi)能力等輪廓信息生成策反方案。發(fā)布訂閱方式互動(dòng)接口總表（續(xù)）分析結(jié)果查詢服務(wù)分 析 結(jié) 果查詢業(yè)務(wù)歷史數(shù)據(jù)分析結(jié)果數(shù)據(jù)集該接口用于經(jīng)營分析系統(tǒng)向外部系統(tǒng)提供歷史報(bào)表訪問。在線請求異步響應(yīng)方式明 細(xì) 數(shù) 據(jù)查詢明細(xì)數(shù)據(jù)結(jié)果數(shù)據(jù)集該接口用于

11、經(jīng)營分析系統(tǒng)向外部系統(tǒng)提供詳細(xì)數(shù)據(jù)訪問。在線請求異步響應(yīng)方式客戶統(tǒng)一視圖服務(wù)客 戶 統(tǒng) 一視圖獲取個(gè)人客戶基本屬性信息該接口用于獲取指定的個(gè)人客戶的基礎(chǔ)屬性相關(guān)信息，包括基本屬性、終端使用、終端功能屬性等。在線請求同步響應(yīng)方式獲取個(gè)人客戶分析屬性信息該接口用于獲取指定的個(gè)人客戶分析屬性信息，包括客戶行為屬性、增值業(yè)務(wù)營銷屬性等。在線請求同步響應(yīng)方式獲取客戶標(biāo)簽屬性信息該接口用于查詢客戶對應(yīng)的客戶標(biāo)簽信息。在線請求同步響應(yīng)方式獲取客戶數(shù)據(jù)及信息業(yè)務(wù)特征信息該接口用于獲取客戶使用數(shù)據(jù)及信息業(yè)務(wù)的行為特征信息。在線請求同步響應(yīng)方式營銷服務(wù)互動(dòng)服務(wù)營銷服務(wù)互動(dòng)服務(wù)p 營銷服務(wù)互動(dòng)服務(wù)的信息交換方式采用

12、發(fā)布訂閱方式。營銷服務(wù)互動(dòng)服務(wù)中的注冊服務(wù)注冊服務(wù)由服務(wù)提供方服務(wù)提供方提供，通知服務(wù)通知服務(wù)由服務(wù)請求方服務(wù)請求方提供。支持營銷服務(wù)互動(dòng)服務(wù)數(shù)據(jù)集有營銷互動(dòng)、資費(fèi)產(chǎn)品推薦互動(dòng)、客戶關(guān)懷互動(dòng)、和策反互動(dòng)等。服務(wù)標(biāo)識服務(wù)標(biāo)識PublishSubscibeService服務(wù)描述服務(wù)描述注冊服務(wù)由服務(wù)提供方提供。服務(wù)請求方調(diào)用注冊服務(wù)，用于起訂或退訂具體的服務(wù)。注冊服務(wù)支持的數(shù)據(jù)集有營銷互動(dòng)、資費(fèi)產(chǎn)品推薦互動(dòng)、客戶關(guān)懷互動(dòng)、和策反互動(dòng)等。在注冊服務(wù)的WSDL服務(wù)描述中需要列出可訂閱數(shù)據(jù)集信息。實(shí)現(xiàn)方式實(shí)現(xiàn)方式基于SOAP的Web服務(wù)。性能要求性能要求單次請求正常網(wǎng)絡(luò)通訊情況下，響應(yīng)時(shí)間必須在2秒之內(nèi)

13、；同一時(shí)間內(nèi)支持的最大并發(fā)請求小于100。方法標(biāo)識方法標(biāo)識RegisterRequest方法描述方法描述服務(wù)請求方調(diào)用注冊服務(wù)（PublishSubscibeService）的注冊方法（RegisterRequest），并發(fā)送請求消息給服務(wù)提供方。服務(wù)提供方訂閱操作完畢，并返回應(yīng)答消息給服務(wù)請求方。 通知服務(wù)通知服務(wù)服務(wù)標(biāo)識服務(wù)標(biāo)識通知服務(wù)標(biāo)識是由服務(wù)請求方在填寫注冊服務(wù)的請求信息中定義的。它是由注冊服務(wù)（PublishSubscibeService）的注冊方法（RegisterRequest）的請求消息中定義的通知服務(wù)標(biāo)識（ServiceID）指定的。服務(wù)描述服務(wù)描述通知服務(wù)由服務(wù)請求方提供

14、。服務(wù)提供方準(zhǔn)備完數(shù)據(jù)，通過調(diào)用通知服務(wù)，告訴服務(wù)請求方數(shù)據(jù)準(zhǔn)備完畢。通知服務(wù)支持的數(shù)據(jù)集有營銷互動(dòng)、資費(fèi)產(chǎn)品推薦互動(dòng)、客戶關(guān)懷互動(dòng)、和策反互動(dòng)等。實(shí)現(xiàn)方式實(shí)現(xiàn)方式基于SOAP的Web服務(wù)。性能要求性能要求單次請求正常網(wǎng)絡(luò)通訊情況下，響應(yīng)時(shí)間必須在2秒之內(nèi)；同一時(shí)間內(nèi)支持的最大并發(fā)請求小于100。方法標(biāo)識方法標(biāo)識通知服務(wù)方法標(biāo)識是由服務(wù)請求方在填寫注冊服務(wù)的請求信息中定義的。它是由注冊服務(wù)（PublishSubscibeService）的注冊方法（RegisterRequest）的請求消息中定義的通知服務(wù)方法標(biāo)識（FunctionID）指定的。方法描述方法描述服務(wù)提供方數(shù)據(jù)準(zhǔn)備完畢后，調(diào)用服務(wù)

15、請求方提供的通知服務(wù)方法并傳遞請求消息。服務(wù)請求方接收到通知，返回應(yīng)答消息給服務(wù)提供方。目錄目錄1 1、總體說明、總體說明3 3、互動(dòng)接口、互動(dòng)接口2 2、數(shù)據(jù)源接口、數(shù)據(jù)源接口4 4、功能接口、功能接口功能接口類別表類別類別代碼代碼接口單元一級類別名稱接口單元一級類別名稱說明說明01省級經(jīng)營分析系統(tǒng)與安全平臺接口主要實(shí)現(xiàn)省級經(jīng)營分析系統(tǒng)與安全平臺對接的接口，如：從帳號登錄、從帳號查詢、角色查詢、從帳號變更、角色變更、從帳號權(quán)限查詢等接口02信息推送接口省級經(jīng)營分析系統(tǒng)通過短信推送接口，彩信推送接口和郵件推送接口功能模塊并通過外部網(wǎng)關(guān)及服務(wù)器發(fā)送給用戶的信息推送類接口。如：短信推送、彩信推送、

16、郵件推送接口。省級經(jīng)營分析系統(tǒng)與省級經(jīng)營分析系統(tǒng)與4A4A安全平臺接口安全平臺接口p從帳號登錄：從帳號登錄：通過改造經(jīng)營分析系統(tǒng)的認(rèn)證管理模塊、數(shù)據(jù)安全管理模塊來實(shí)現(xiàn)4A管理平臺與經(jīng)營分析系統(tǒng)之間的單點(diǎn)登錄（SSO）、集中認(rèn)證，接收請求并返回認(rèn)證結(jié)果；p從帳號查詢：從帳號查詢：通過改造經(jīng)營分析系統(tǒng)的用戶管理模塊、數(shù)據(jù)安全管理模塊來實(shí)現(xiàn)4A管理平臺對經(jīng)營分析系統(tǒng)中從帳號及屬性的查詢；p角色查詢：角色查詢：通過改造經(jīng)營分析系統(tǒng)的用戶管理模塊、數(shù)據(jù)安全管理模塊來實(shí)現(xiàn)4A管理平臺對經(jīng)營分析系統(tǒng)中角色及屬性的查詢；p從帳號變更：從帳號變更：通過改造經(jīng)營分析系統(tǒng)的用戶管理模塊、數(shù)據(jù)安全管理模塊來實(shí)現(xiàn)4A管

17、理平臺對經(jīng)營分析系統(tǒng)中從帳號及屬性的變更、同步；p角色變更：角色變更：通過改造經(jīng)營分析系統(tǒng)的用戶管理模塊、數(shù)據(jù)安全管理模塊來實(shí)現(xiàn)4A管理平臺對經(jīng)營分析系統(tǒng)中角色及屬性的變更、同步；p從帳號權(quán)限查詢：從帳號權(quán)限查詢：通過改造經(jīng)營分析系統(tǒng)的權(quán)限管理模塊、數(shù)據(jù)安全管理模塊來實(shí)現(xiàn)4A管理平臺對經(jīng)營分析系統(tǒng)中從帳號角色關(guān)系、從帳號細(xì)粒度權(quán)限的查詢；p角色權(quán)限查詢：角色權(quán)限查詢：通過改造經(jīng)營分析系統(tǒng)的權(quán)限管理模塊、數(shù)據(jù)安全管理模塊來實(shí)現(xiàn)4A管理平臺對經(jīng)營分析系統(tǒng)中角色的權(quán)限的查詢；p從帳號角色變更：從帳號角色變更：通過改造經(jīng)營分析系統(tǒng)的權(quán)限管理模塊、數(shù)據(jù)安全管理模塊來實(shí)現(xiàn)4A管理平臺對經(jīng)營分析系統(tǒng)中從帳號的角色關(guān)系變更、同步；p從帳號權(quán)限變更：從帳號權(quán)限變更：改造經(jīng)營分析系統(tǒng)的權(quán)限管理模塊、數(shù)據(jù)安全管理模塊，實(shí)現(xiàn)通過4A管理平臺對經(jīng)營分析系統(tǒng)中從帳號細(xì)粒度權(quán)限變更；p審計(jì)日志傳送：審計(jì)日志傳送：通過改造經(jīng)營分析系統(tǒng)的審計(jì)日志記錄和數(shù)據(jù)安全管理模塊來實(shí)現(xiàn)4A管理平臺對經(jīng)營分析系統(tǒng)中登錄記錄和關(guān)鍵操作記錄的過濾、格式化和發(fā)送。信息推送接口信息推送接口p 短信推送接口功能短信推送接口功能短信推送接口功能模塊負(fù)責(zé)通過CMPP協(xié)議與短信網(wǎng)關(guān)交互，使經(jīng)營分析門戶的信息以短信方式發(fā)送給用戶。短信通知接口支持短信的群發(fā)與定時(shí)發(fā)送，傳輸?shù)膬?nèi)容包括發(fā)送流水號、