NG1-BASS20規(guī)范培訓-外部接口分冊

1、中國移動省級NG1-BASS技術規(guī)范外部接口分冊2022年5月9日星期一目錄目錄1 1、總體說明、總體說明3 3、互動接口、互動接口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ù)據(jù)接口的建設進度統(tǒng)一規(guī)范省級經(jīng)營分析系統(tǒng)和源系統(tǒng)之間的連接關系和接口特性，規(guī)范各數(shù)據(jù)單元的接口格式4采用數(shù)據(jù)封裝機制，統(tǒng)一規(guī)范省級經(jīng)營分析系統(tǒng)向各外部系統(tǒng)提供信息服務的標準和接口內(nèi)容 接口規(guī)范原則接口規(guī)范原則在滿足業(yè)務需求的前提下，使接口數(shù)據(jù)量最少，最大

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

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

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

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

6、292財務類接口單元財務類接口單元p本次規(guī)范新增財務類接口。具體包括：廣告成本、宣傳成本、通信網(wǎng)運營成本、營銷機構成本、銷售費用、管理費用六個接口。9494網(wǎng)絡信令接口單元網(wǎng)絡信令接口單元p停止了9400194008接口；對原有的94009 A接口做了增加和修訂，同時新增了94010 Gb信令接口。0101客戶管理接口單元客戶管理接口單元p修改的接口有：01001、01002、01003、01007、01028等；新增接口：01035等；p停止接口：01013、01015、01019、01034等。0202客戶服務接口單元客戶服務接口單元p對數(shù)據(jù)源分類做了修改，部分接口單元的說明和字段做了修訂

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

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

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

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

11、請求異步響應方式客戶統(tǒng)一視圖服務客 戶 統(tǒng) 一視圖獲取個人客戶基本屬性信息該接口用于獲取指定的個人客戶的基礎屬性相關信息，包括基本屬性、終端使用、終端功能屬性等。在線請求同步響應方式獲取個人客戶分析屬性信息該接口用于獲取指定的個人客戶分析屬性信息，包括客戶行為屬性、增值業(yè)務營銷屬性等。在線請求同步響應方式獲取客戶標簽屬性信息該接口用于查詢客戶對應的客戶標簽信息。在線請求同步響應方式獲取客戶數(shù)據(jù)及信息業(yè)務特征信息該接口用于獲取客戶使用數(shù)據(jù)及信息業(yè)務的行為特征信息。在線請求同步響應方式營銷服務互動服務營銷服務互動服務p 營銷服務互動服務的信息交換方式采用發(fā)布訂閱方式。營銷服務互動服務中的注冊服務注

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

13、法標識方法標識RegisterRequest方法描述方法描述服務請求方調(diào)用注冊服務（PublishSubscibeService）的注冊方法（RegisterRequest），并發(fā)送請求消息給服務提供方。服務提供方訂閱操作完畢，并返回應答消息給服務請求方。 通知服務通知服務服務標識服務標識通知服務標識是由服務請求方在填寫注冊服務的請求信息中定義的。它是由注冊服務（PublishSubscibeService）的注冊方法（RegisterRequest）的請求消息中定義的通知服務標識（ServiceID）指定的。服務描述服務描述通知服務由服務請求方提供。服務提供方準備完數(shù)據(jù)，通過調(diào)用通知服務，告

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

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

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

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