精品資料（2021-2022年收藏）中國聯(lián)通增值業(yè)務鑒權中心接口規(guī)范VAC與SP接口規(guī)范1218重點

1、QB/CUXXX-200X ××××××××中國聯(lián)通公司發(fā)布××××-××-××實施××××-××-××發(fā)布中國聯(lián)通VAC平臺接口技術要求：VAC與SP接口規(guī)范（暫定名）（V1.1）QB/CU ×××××××中國聯(lián)通公司企業(yè)標準新SPMS上線后需要SP與VAC平臺連接，請進行接口開發(fā)I、按

2、照附件進行接口開發(fā)，2009年2月20日前與愛立信VAC平臺進行聯(lián)調(diào)。廠家溫工 2、原有接口不動，保證現(xiàn)有業(yè)務正常使用. 3、2009年2月底前沒有調(diào)測完成的SP做下線處理，聯(lián)系人：呂艷霞156471020836中國聯(lián)通VAC平臺接口技術要求：VAC與SP接口規(guī)范（V1.1）III目 次修改記錄II前 言III1 范圍42 規(guī)范性引用文件43 定義與縮略語43.1 定義43.2 縮略語43.3 信息更新時機定義54 VAC和SP間的接口54.1 定購通知接口54.1.1 接口描述54.1.2 發(fā)起方系統(tǒng)54.1.3 接受方系統(tǒng)54.1.4 接口協(xié)議54.1.5 接口內(nèi)

3、容 訂購關系通知SP請求（OrderRelationUpdateNotifyReq） 訂購關系通知SP響應（OrderRelationUpdateNotifyRsp）64.2 定購關系同步接口64.2.1 接口描述64.2.2 發(fā)起方系統(tǒng)74.2.3 接受方系統(tǒng)74.2.4 接口協(xié)議74.2.5 接口內(nèi)容 請求文件頭（定長） 文件體74.2.6 過渡階段定制關系變更通知SP通用流程8修改記錄文件編號版本號擬制人/修改人擬制/修改日期更改理由主要更改內(nèi)容（寫要點即可）封面V1.12008-12-18版本號修改從1.0改為1.14.1

4、.3增加本節(jié)注1：每次更改歸檔文件時，需填寫此表。注2：文件第一次歸檔時，“更改理由”、“主要更改內(nèi)容”欄寫“無”。前 言本標準是中國聯(lián)通增值業(yè)務鑒權中心系列標準之一，本系列標準的預期結(jié)構(gòu)如下：中國聯(lián)通增值業(yè)務鑒權中心（VAC）技術體制本標準將根據(jù)業(yè)務的開展情況與市場需求，適時進行修改。本標準由中國聯(lián)通公司增值業(yè)務部提出。本標準由中國聯(lián)通公司技術部歸口。本標準主要起草單位：中訊郵電咨詢設計院，中國聯(lián)通增值業(yè)務部本標準主要起草人：×××本標準的修改和解釋權屬中國聯(lián)通公司。中國聯(lián)通增值業(yè)務鑒權中心接口技術要求：VAC平臺與SP接口規(guī)范（V1.1）1 范圍本標準規(guī)定了中

5、國聯(lián)通VAC與SP之間的接口。適用于聯(lián)通、省分公司和廠家進行VAC和SP系統(tǒng)互聯(lián)建設的研制、開發(fā)和實施，是中國聯(lián)通VAC、SP接入規(guī)劃和建設的基本依據(jù)。2 規(guī)范性引用文件下列文件中的條款通過本標準的引用而成為本標準的條款。凡是注日期的引用文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于本標準，然而，鼓勵根據(jù)本標準達成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本標準。3 定義與縮略語3.1 定義本標準采用以下定義：1) 業(yè)務：業(yè)務是一定的內(nèi)容和/或服務能力的聚合。業(yè)務名稱是用戶用以識別不同的增值業(yè)務的標識。在管理上，業(yè)務是服務提供商與運營商

6、進行審核管理和分成結(jié)算的對象。如“新浪酷圖”業(yè)務。2) 業(yè)務能力：指基礎增值服務，例如：郵件、消息、瀏覽、流媒體等，可以使用這些業(yè)務能力進行組合，構(gòu)造出特定的業(yè)務，滿足細分市場后的用戶需求。3) 業(yè)務引擎：指實現(xiàn)各個業(yè)務能力的物理實體。4) 產(chǎn)品：產(chǎn)品是對業(yè)務的標價，是用戶購買業(yè)務的方式，即用戶使用業(yè)務所需要支付的價錢、支付的方式、以及其能夠獲得的使用額度。在VAC系統(tǒng)中，產(chǎn)品是訂購、鑒權、和計費的對象，如“包月5元”。一個業(yè)務對應多個產(chǎn)品，一個產(chǎn)品唯一對應一個業(yè)務。5) 內(nèi)容：內(nèi)容是用戶真正使用的對象，是在業(yè)務中提供的一個個實體，如“手機酷圖”業(yè)務中的一個圖片。6) 門戶：指直接面對用戶的界

7、面。增值業(yè)務鑒權中心通過多種承載形式提供給用戶多樣化的操作能力，如業(yè)務訂購、取消、查詢、導購、幫助等?；诓煌某休d形式，門戶可以包括WAP門戶、WEB門戶、短信門戶和語音門戶。3.2 縮略語本標準采用以下縮略語：VACValue-added Service Platform增值業(yè)務鑒權中心AAAAuthentication Authorization Account認證授權計費BrewBinary Runtime Environment for Wireless無線二進制運行環(huán)境CDMACode Division Multiple Access碼分多址DMDevice Management設

8、備管理DRMDigital Right Management數(shù)字版權管理IMInstant Massage即時消息GSMGlobal System for Mobile communication全球移動通信系統(tǒng)GPRSGeneral Packet Radio Service通用無線分組業(yè)務LCSLocation Services定位業(yè)務MMSMultimedia Messaging Service多媒體消息服務OTAOver the Air空中下載PIMPersonal Information Management個人信息管理PoCPTT over the Cellular基于蜂窩網(wǎng)的PTT

9、業(yè)務PTTPush to Talk一按即說SLAService Level Agreement服務品質(zhì)協(xié)議SPService Provider服務提供商SSGService Select Gateway業(yè)務選擇網(wǎng)關TTSText-To-Speech文本語音轉(zhuǎn)換WAPWireless Application Protocol無線應用協(xié)議3.3 信息更新時機定義- 對于新增的CP/SP，當?shù)谝淮无D(zhuǎn)為測試狀態(tài)，第一次轉(zhuǎn)為商用狀態(tài)時，分別需要更新一次；- 對于已有CP/SP，信息發(fā)生變化時，需要更新；除以上兩種情況外，BSS不能向VAC傳遞CP/SP信息。4 VAC和SP間的接口4.1 定購通知接口4

10、.1.1 接口描述用戶訂購關系發(fā)生變化時以及用戶點播SP業(yè)務時，VAC通過此接口實時通知SP。批開、批退時不采用此接口通知SP，通過FTP訂購關系同步接口通知SP。通知失敗時，根據(jù)配置，VAC可進行重試，重試失敗則記錄日志，之后通過FTP訂購關系同步接口進行補償。為減少SP改造的工作量，保留原聯(lián)通在信平臺SGIP與WAP平臺（總部）Http兩種通知SP的方式， SP可以從三種方式中選擇任意一種。4.1.2 發(fā)起方系統(tǒng)VAC。4.1.3 接受方系統(tǒng)SP。4.1.4 接口協(xié)議該接口采用Web Service方式。4.1.5 接口內(nèi)容 訂購關系通知SP請求（OrderRelationU

11、pdateNotifyReq）參數(shù)名類型大小描述RecordSequenceIDstring18流水號, UserIdTypeinteger4用戶ID類型1: MSISDN2: PsedoCodeUserIdstring36用戶手機號碼或偽碼UserIdType填1 為手機號碼UserIdType填2 為偽碼ServiceTypeString2業(yè)務類型,見附錄SpIdstring21SP標識ProductIdstring21產(chǎn)品標識（此為SP在PRM側(cè)申請的SP_Productid）UpdateTypeinteger4更新操作的類型包括：1：訂購2：取消訂購3：點播UpdateTimestri

12、ng14更新時間UpdateDescstring100更新操作的詳細描述，默認為空LinkIDstring20事務關聯(lián)ID，用于點播業(yè)務的臨時定購關系關聯(lián)，由平臺產(chǎn)生。格式如下：MMDDHHMMSS+10位隨機序列號；為空表示無效。用戶點播時使用。Contentstring140內(nèi)容EffectiveDatestring14訂購關系生效時間, 格式：yyyyMMddhhmmssExpireDatestring14訂購關系失效時間, 格式：yyyyMMddhhmmss 訂購關系通知SP響應（OrderRelationUpdateNotifyRsp）參數(shù)名類型字節(jié)大小描述Record

13、SequenceIDstring18流水號，與OrderRelationUpdateNotifyReq的流水號相同ResultCode integer4結(jié)果識別碼0: 成功1. 失敗4.2 定購關系同步接口4.2.1 接口描述該接口用于VAC與SP每天稽核增量訂購關系。包括批量定購和退訂。VAC將每天增量文件放到VAC為SP提供的文件服務器的目錄下。雙方通過文件傳輸實現(xiàn)接口。文件服務器上設定具有對相應目錄存取權限的用戶。VAC為SP分配具有讀寫文件權限的用戶和密碼。系統(tǒng)于每天凌晨1：00進行稽核文件資料同步。資料同步周期應具有根據(jù)最新規(guī)定進行可調(diào)的能力。文件采用ASCII文本格式,各屬性間使用

14、t分隔，在生成記錄時若相應的屬性值為空，直接用分隔符隔開，分隔符之間無其他符號。文件體中一行作為一條記錄，各條記錄之間用換行符n作為分隔并在文件中連續(xù)書寫。文件頭定長，文件體不定長。文件的維護由VAC負責。4.2.2 發(fā)起方系統(tǒng)VAC。4.2.3 接受方系統(tǒng)SP。4.2.4 接口協(xié)議FTP 文件。4.2.5 接口內(nèi)容文件目錄<根目錄>/VAC/SubscribeInfo/<SPID>/文件命名: SubscribeInfo+SPID+yyyyMMddHHmm+xxx+nnnn.txtSPID 八位，不足八位，左補零文件產(chǎn)生的時間（12位yyyyMMddHHmm精確到年月

15、日時分）xxx為省分代碼。nnnn 是4位序列號，每天從“0001”開始，到達”9999”后又從“0001”開始。 請求文件頭（定長）序號屬性名長度備注1文件序列號(流水號)CHAR(4)0001開始，排滿9999后重新循環(huán)2版本信息CHAR(5)缺?。?00003文件產(chǎn)生時間CHAR(14)yyyymmddhhmmss4文件生成方系統(tǒng)代碼CHAR(3)9025記錄開始日期時間CHAR(14)yyyymmddhhmmss6記錄結(jié)束日期時間CHAR(14)yyyymmddhhmmss7總記錄數(shù)CHAR(10)8備用CHAR(40)9換行CHAR(1) 文件體參數(shù)名類型

16、大小描述RecordSequenceIDstring18流水號, UserIdTypeinteger4用戶ID類型1: MSISDN2: PsedoCodeUserIdstring36用戶手機號碼或偽碼UserIdType填1 為手機號碼UserIdType填2 為偽碼ServiceTypeString2業(yè)務類型,見附錄A7SpIdstring21SP標識ProductIdstring21產(chǎn)品標識（此為SP在PRM側(cè)申請的SP_Productid）UpdateTypeinteger4更新操作的類型包括：1：訂購2：取消訂購3：點播UpdateTimestring14更新時間UpdateDescstring100更新操作的詳細描述，默認為空LinkIDstring20事務關聯(lián)ID，用于點播業(yè)務的臨時定購關系關聯(lián)，由平臺產(chǎn)生。格式如下：MMDDHHMMSS+10位隨機序列號；為空表示無效。用戶點播時使用。Contentstring140內(nèi)容EffectiveDatestring14訂購關系生效時間, 格式：yyyyMMddhhmmssExpireDatestring14訂