IPTV業(yè)務(wù)管理平臺(tái)與業(yè)務(wù)系統(tǒng)接口技術(shù).doc

文件編號(hào)：SHDX/ZS/CZ/JG/002/A/2008中國電信集團(tuán)上海市電信公司IPTV業(yè)務(wù)管理平臺(tái)與業(yè)務(wù)系統(tǒng)接口技術(shù)規(guī)范V2.21 目的本規(guī)范是在中國電信集團(tuán)公司發(fā)布的IPTV業(yè)務(wù)管理平臺(tái)與業(yè)務(wù)系統(tǒng)接口技術(shù)規(guī)范V2.0的基礎(chǔ)上，根據(jù)中國電信上海公司IPTV運(yùn)營的實(shí)際情況，進(jìn)一步調(diào)整修訂而成的。本規(guī)范供引入IPTV能力平臺(tái)設(shè)備、IPTV業(yè)務(wù)管理平臺(tái)設(shè)備時(shí)參照執(zhí)行。本技術(shù)規(guī)范的增補(bǔ)、修訂和解釋權(quán)歸中國電信上海公司所有。如中國電信上海公司在此之前的文件與本技術(shù)規(guī)范有矛盾，按此技術(shù)規(guī)范執(zhí)行。本技術(shù)規(guī)范自發(fā)布之日起實(shí)施。2 適用范圍本規(guī)范規(guī)定了IPTV業(yè)務(wù)管理平臺(tái)與業(yè)務(wù)系統(tǒng)之間的接口。本規(guī)范適用于IPTV業(yè)務(wù)管理平臺(tái)、EPG服務(wù)系統(tǒng)、內(nèi)容分發(fā)系統(tǒng)之間的接口開發(fā)。為中國電信上海公司IPTV機(jī)頂盒和平臺(tái)的接口開放的測試提供依據(jù)。為中國電信上海公司IPTV能力平臺(tái)設(shè)備、IPTV業(yè)務(wù)管理平臺(tái)設(shè)備的選擇提供了依據(jù)。3 引用文件/標(biāo)準(zhǔn)下列文件中的條款通過本標(biāo)準(zhǔn)的引用而成為本標(biāo)準(zhǔn)的條款。凡是注日期的引用文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于本標(biāo)準(zhǔn)，然而，鼓勵(lì)根據(jù)本標(biāo)準(zhǔn)達(dá)成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本標(biāo)準(zhǔn)。RFC2616: Hypertext Transfer ProtocolRFC3275: Extensible Makeup LanguageW3C: Web Services Description LanguageIPTV業(yè)務(wù)管理平臺(tái)技術(shù)規(guī)范4 定義/術(shù)語EPGElectronic Programmer Guide電子節(jié)目單HTTPHypertext Transfer Protocol超文本傳輸協(xié)議IP Internet Protocol 網(wǎng)絡(luò)協(xié)議 MAC Media Access Control 媒體訪問控制層SOAPSimple Object Access Protocol 簡單對象訪問協(xié)議STBSet Top Box機(jī)頂盒URL Uniform Resource Locator 統(tǒng)一資源定位符5 IPTV業(yè)務(wù)管理平臺(tái)與業(yè)務(wù)系統(tǒng)接口5.1 總體框架業(yè)務(wù)系統(tǒng)包括EPG服務(wù)系統(tǒng)、內(nèi)容分發(fā)系統(tǒng)、增值業(yè)務(wù)系統(tǒng)和其他IPTV的業(yè)務(wù)系統(tǒng)，IPTV業(yè)務(wù)管理平臺(tái)與業(yè)務(wù)系統(tǒng)的總體框架如圖所示：業(yè)務(wù)管理平臺(tái)EPG服務(wù)系統(tǒng)內(nèi)容分發(fā)系統(tǒng)其他業(yè)務(wù)系統(tǒng)業(yè)務(wù)系統(tǒng)增值業(yè)務(wù)系統(tǒng)圖5-1-1：IPTV業(yè)務(wù)管理平臺(tái)與業(yè)務(wù)系統(tǒng)框架圖IPTV業(yè)務(wù)管理平臺(tái)與業(yè)務(wù)系統(tǒng)接口包括以下接口：a) EPG首頁鑒權(quán)接口l 接口描述：本接口在用戶訪問EPG首頁時(shí)，EPG服務(wù)系統(tǒng)向業(yè)務(wù)管理平臺(tái)請求鑒權(quán)。l 承載協(xié)議：SOAPb) UserToken更新接口l 接口描述：本接口在用戶令牌UserToken（參見機(jī)頂盒與IPTV業(yè)務(wù)運(yùn)營平臺(tái)接口技術(shù)規(guī)范）失效時(shí)，EPG服務(wù)系統(tǒng)重定向到業(yè)務(wù)管理平臺(tái)請求新的UserToken。l 承載協(xié)議：HTTPc) Session丟失后獲取接口l 接口描述：本接口機(jī)頂盒訪問EPG平臺(tái)時(shí)，EPG平臺(tái)通過Session（或cookie）記憶用戶的臨時(shí)身份憑證（UserToken）。但是，由于Session（或Cookie）的時(shí)限性，使得機(jī)頂盒在一段時(shí)間內(nèi)沒有訪問EPG頁面時(shí)，機(jī)頂盒將丟失與EPG之間的Session，從而使得EPG丟失用戶的UserToken，無法繼續(xù)為該用戶機(jī)頂盒提供IPTV服務(wù)。l 承載協(xié)議：HTTPd) 業(yè)務(wù)鑒權(quán)接口l 接口描述：本接口在用戶通過EPG請求業(yè)務(wù)資源時(shí)，EPG服務(wù)系統(tǒng)向業(yè)務(wù)管理平臺(tái)請求業(yè)務(wù)鑒權(quán)，業(yè)務(wù)管理平臺(tái)將鑒權(quán)結(jié)果返回給EPG服務(wù)系統(tǒng)。l 承載協(xié)議：SOAPe) 業(yè)務(wù)訂購接口l 接口描述：本接口在用戶請求使用業(yè)務(wù)時(shí)，EPG服務(wù)系統(tǒng)向業(yè)務(wù)管理平臺(tái)請求業(yè)務(wù)訂購，用戶完成訂購后，EPG服務(wù)系統(tǒng)保存訂購信息，再返回處理頁面給用戶。l 承載協(xié)議：SOAPf) 直播頻道列表更新接口l 接口描述：本接口在用戶請求訂購直播頻道，當(dāng)業(yè)務(wù)管理平臺(tái)返回訂購成功響應(yīng)后，EPG服務(wù)系統(tǒng)將用戶重定向至業(yè)務(wù)管理平臺(tái)，要求重新設(shè)置直播頻道列表。業(yè)務(wù)管理平臺(tái)通過CTCSetConfig設(shè)置訂購成功的頻道列表，并將機(jī)頂盒重定向至EPG服務(wù)系統(tǒng)。l 承載協(xié)議：HTTPg) 產(chǎn)品包信息獲取接口l 接口描述：本接口為EPG服務(wù)系統(tǒng)向業(yè)務(wù)管理平臺(tái)請求產(chǎn)品包信息，業(yè)務(wù)管理系統(tǒng)將產(chǎn)品包信息返回給EPG服務(wù)系統(tǒng)。l 承載協(xié)議：SOAPh) 用戶身份重定向接口l 接口描述：本接口在用戶請求使用業(yè)務(wù)時(shí)，接收到HTTP重定向命令，要求重定向到業(yè)務(wù)管理平臺(tái)的業(yè)務(wù)訂購頁面時(shí)觸發(fā)，用戶完成訂購后，EPG服務(wù)系統(tǒng)保存訂購信息，再返回處理頁面給用戶。l 承載協(xié)議：HTTPi) 增值業(yè)務(wù)訂購查詢接口l 接口描述：增值業(yè)務(wù)平臺(tái)向業(yè)務(wù)管理平臺(tái)請求查詢用戶訂購過的所有產(chǎn)品信息。l 承載協(xié)議：SOAPj) 增值業(yè)務(wù)產(chǎn)品詳細(xì)信息查詢接口l 接口描述：增值業(yè)務(wù)平臺(tái)向業(yè)務(wù)管理平臺(tái)請求查詢用戶訂購過的產(chǎn)品詳細(xì)信息。l 承載協(xié)議：SOAPk) 增值業(yè)務(wù)產(chǎn)品訂購接口l 接口描述：當(dāng)用戶選擇訂購某增值業(yè)務(wù)時(shí)，增值業(yè)務(wù)平臺(tái)將用戶重定向至業(yè)務(wù)管理平臺(tái)進(jìn)行該增值業(yè)務(wù)的訂購。當(dāng)用戶訂購成功后，業(yè)務(wù)管理平臺(tái)能將用戶重定向回增值業(yè)務(wù)平臺(tái)顯示訂購結(jié)果。l 承載協(xié)議：HTTPl) 業(yè)務(wù)能力系統(tǒng)數(shù)據(jù)采集接口l 接口描述：為了進(jìn)行IPTV業(yè)務(wù)的經(jīng)營分析需要向IPTV平臺(tái)采集相關(guān)數(shù)據(jù)。l 承載協(xié)議：FTP（【注】當(dāng)業(yè)務(wù)能力平臺(tái)、增值業(yè)務(wù)系統(tǒng)與業(yè)務(wù)管理平臺(tái)進(jìn)行橫向SOAP接口進(jìn)行交互時(shí)，能夠?qū)M向接口連接情況進(jìn)行監(jiān)測，并在橫向接口連接時(shí)間超過10s的情況下通過錯(cuò)誤提示頁面告知用戶，并要求機(jī)頂盒重新發(fā)起認(rèn)證請求。）5.2 EPG首頁鑒權(quán)接口5.2.1 接口時(shí)序STB業(yè)務(wù)管理平臺(tái)a）HTTP請求d）HTTP響應(yīng)EPG服務(wù)系統(tǒng)b）SOAP請求c）SOAP響應(yīng)圖5-2-1-1：EPG首頁鑒權(quán)流程5.2.2 接口協(xié)議內(nèi)容承載協(xié)議：SOAP接口方向：EPG服務(wù)系統(tǒng) 業(yè)務(wù)管理平臺(tái)接口功能：EPG服務(wù)系統(tǒng)向業(yè)務(wù)管理平臺(tái)請求鑒權(quán)，通過鑒權(quán)后再給用戶下發(fā)EPG首頁SOAP接口請求消息EPGAuth包含如下信息： 表5-2-2-1：請求EPGAuth名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選UserToken業(yè)務(wù)管理平臺(tái)為該用戶分配的臨時(shí)身份證明String32MSOAP接口應(yīng)答消息EPGAuthResponse包含以下信息：表5-2-2-2：響應(yīng)EPGAuthResponse名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選UserIDIPTV用戶業(yè)務(wù)編號(hào)String36MResult結(jié)果，0：成功 其他：失敗String4MDescription結(jié)果描述String256OUserGroupNMB用戶對應(yīng)的用戶分組信息標(biāo)識(shí)String8OEPGGroupNMB用戶對應(yīng)的EPG分組信息標(biāo)識(shí)String8MSTBID機(jī)頂盒編號(hào)string32OMAC機(jī)頂盒的MAC地址，格式為：xx:xx:xx:xx:xx:xxString13OProducts用戶已購買的IPTV 產(chǎn)品編號(hào)組合，組合間采用”;”分隔，組合內(nèi)采用”,”分隔，分別為產(chǎn)品ID，內(nèi)容ID，可以為以下情形：1、 ProductID：表示整個(gè)產(chǎn)品的訂購關(guān)系，且有效期未知；2、 ProductID,ExpiredTime ：表示整個(gè)產(chǎn)品的訂購關(guān)系，且存在有效期；3、 ProductID,ContentID：未知有效期的內(nèi)容訂購關(guān)系，如ContentID 為直播頻道ID，則為直播頻道訂購關(guān)系，如為點(diǎn)播內(nèi)容ID，則為點(diǎn)播內(nèi)容訂購關(guān)系；4、 ProductID,ExpiredTime,ContentID：存在有效期的內(nèi)容訂購關(guān)系， 如ContentID 為直播頻道ID，則為直播頻道訂購關(guān)系，如為點(diǎn)播內(nèi)容ID，則為點(diǎn)播內(nèi)容訂購關(guān)系。String不定OTokenExpiredTimeUserToken的失效時(shí)間， 格式為：YYYYMMDDhhmmss。缺少該參數(shù)表示在一次登錄期間，永久有效。String14O5.3 UserToken更新接口5.3.1 接口時(shí)序STBEPG服務(wù)系統(tǒng)業(yè)務(wù)管理平臺(tái)a）Http請求b）UserToken 未過期c）Http響應(yīng)d）UserToken 已過期e）重定向h）返回新的UserTokenf）頻道更新或重認(rèn)證g）頻道更新或重認(rèn)證結(jié)束請求圖5-3-1-1：UserToken更新流程圖用戶UserToken更新過程如下：a) STB向EPG服務(wù)系統(tǒng)發(fā)起http請求。b) EPG服務(wù)系統(tǒng)檢查UserToken是否過期，如果未過期，則跳轉(zhuǎn)到c，如果已過期，則跳轉(zhuǎn)到e。c) EPG服務(wù)系統(tǒng)響應(yīng)請求。d) UserToken已過期。e) EPG服務(wù)系統(tǒng)將用戶請求重定向到業(yè)務(wù)管理平臺(tái)，請求新的UserToken，請求參數(shù)ReturnURL,OldUserToken，Action。f) 如業(yè)務(wù)管理平臺(tái)需要STB重新認(rèn)證或發(fā)生頻道更改需要更新頻道列表，則下發(fā)重認(rèn)證頁面或頻道更新頁面；g) STB重新認(rèn)證或更新頻道結(jié)束后，由頁面邏輯控制發(fā)起重定向請求；h) 業(yè)務(wù)管理平臺(tái)返回新的UserToken，返回參數(shù)NewUserToken、Result。（【注】：IPTV業(yè)務(wù)能力平臺(tái)在完成用戶UserToken更新后都應(yīng)該再次發(fā)起首頁鑒權(quán)請求，以保證當(dāng)前用戶已訂購產(chǎn)品列表為最新且可用的。）5.3.2 接口協(xié)議內(nèi)容承載協(xié)議：HTTP GET接口方向：EPG服務(wù)系統(tǒng)重定向 業(yè)務(wù)管理平臺(tái)接口功能：UserToken失效時(shí)，EPG服務(wù)系統(tǒng)重定向到業(yè)務(wù)管理平臺(tái)請求新的UserToken。請求消息包含以下關(guān)鍵參數(shù)表5-3-2-1：更新UserToken請求參數(shù)說明名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選SPIDSP的唯一標(biāo)識(shí)String8OUserIDIPTV用戶業(yè)務(wù)編號(hào)string36OOldUserToken過期的UserTokenString32MReturnURL更新UserToken后返回的URL，采用URLEncoding的ANSI方式string256MAction操作類型，此處使用：“UserTokenExpired”String20M響應(yīng)消息表5-3-2-2：更新UserToken返回參數(shù)說明名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選SPIDSP的唯一標(biāo)識(shí)String8OUserIDIPTV用戶業(yè)務(wù)編號(hào)string36MNewUserToken新的UserTokenString32MResult更新結(jié)果 0：成功 其他：失敗String4MTokenExpiredTimeUserToken的失效時(shí)間，格式為：YYYYMMDDhhmmss。缺少該參數(shù)表示永久有效。String14O5.4 Session丟失后獲取接口機(jī)頂盒訪問EPG平臺(tái)時(shí)，EPG平臺(tái)通過Session（或cookie）記憶用戶的臨時(shí)身份憑證（UserToken）。但是，由于Session（或Cookie）的時(shí)限性，使得機(jī)頂盒在一段時(shí)間內(nèi)沒有訪問EPG頁面時(shí)，機(jī)頂盒將丟失與EPG之間的Session，從而使得EPG丟失用戶的UserToken，無法繼續(xù)為該用戶機(jī)頂盒提供IPTV服務(wù)。5.4.1 接口時(shí)序?yàn)榱私鉀Q這一問題，可以采用SSO流程獲取用戶的UserToken。以下是機(jī)頂盒與EPG交互、Session丟失和EPG處理流程：a). 機(jī)頂盒開機(jī)認(rèn)證通過，業(yè)務(wù)管理平臺(tái)為其分配臨時(shí)身份憑證UserTokenb). 機(jī)頂盒訪問EPG首頁，攜帶UserTokenc). EPG以Session（或Cookie）方式保存用戶的UserTokend). EPG在調(diào)用業(yè)務(wù)管理平臺(tái)的業(yè)務(wù)鑒權(quán)、產(chǎn)品訂購時(shí)必需攜帶有效的UserToken。EPG通過UserToken更新機(jī)制來保證UserToken的有效性。e). 機(jī)頂盒通過訪問EPG頁面來維持機(jī)頂盒與EPG之間的Session有效。機(jī)頂盒在一段時(shí)間內(nèi)沒有操作或者機(jī)頂盒離開EPG訪問增值業(yè)務(wù)，超過Session的超時(shí)時(shí)限，機(jī)頂盒丟失與EPG之間的Session。f). 機(jī)頂盒再次訪問EPG，EPG因Session丟失，無法獲得機(jī)頂盒的UserTokeng). EPG系統(tǒng)將機(jī)頂盒重定向到業(yè)務(wù)管理系統(tǒng)，發(fā)起用戶身份重定向SSO請求, 攜帶ReturnURL等參數(shù)h). 業(yè)務(wù)管理平臺(tái)獲取機(jī)頂盒的UserToken后，通過通過重定向攜帶參數(shù)方式，將UserToken等參數(shù)返回給EPG系統(tǒng)i). EPG獲得用戶身份，繼續(xù)為用戶提供服務(wù)。5.4.2 接口協(xié)議內(nèi)容承載協(xié)議：HTTP SSO接口方向：EPG服務(wù)系統(tǒng) 業(yè)務(wù)管理平臺(tái)接口功能：采用SSO流程獲取用戶的UserToken。業(yè)務(wù)身份重定向SSO請求參數(shù)：表5-4-2-1：業(yè)務(wù)身份重定向SSO請求參數(shù)說明名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選SPIDSP的唯一標(biāo)識(shí)string8MReturnURL返回增值業(yè)務(wù)系統(tǒng)頁面的URLstring256MReturnInfo返回增值業(yè)務(wù)系統(tǒng)頁面需要攜帶的額外信息，可用于區(qū)分不同的SSO請求string256OAction操作類型，此處使用：UserTokenRequeststring20M業(yè)務(wù)身份重定向SSO返回參數(shù)：表5-4-2-2：業(yè)務(wù)身份重定向SSO響應(yīng)參數(shù)說明名稱說明數(shù)據(jù)類型長度(字節(jié))是否必選Result身份獲取結(jié)果0：成功；其他：失敗string4MUserTokenIPTV用戶業(yè)務(wù)編號(hào)string36MSPIDSP的唯一標(biāo)識(shí)string8OUserIDIPTV用戶業(yè)務(wù)編號(hào)string36OEPGGroupNMB用戶對應(yīng)的EPG分組信息標(biāo)識(shí)string8OUserGroupNMB用戶對應(yīng)的分組信息標(biāo)識(shí)string8ODescription結(jié)果描述string256OExpiredTimeUserToken的失效時(shí)間，格式為YYYYMMDDhhmmss。缺少在一次開機(jī)過程中該參數(shù)表示永久有效。string14OReturnInfo返回EPG頁面需要攜帶的額外信息，可用于區(qū)分不同的SSO請求string256O5.5 業(yè)務(wù)鑒權(quán)5.5.1 接口時(shí)序業(yè)務(wù)鑒權(quán)接口時(shí)序流程如下：圖5-4-1-1：業(yè)務(wù)鑒權(quán)流程圖a) 終端訪問業(yè)務(wù)系統(tǒng)的業(yè)務(wù)使用入口，請求使用某項(xiàng)業(yè)務(wù)；b) 業(yè)務(wù)系統(tǒng)要求鑒權(quán)，發(fā)起到業(yè)務(wù)管理平臺(tái)的SOAP請求，攜帶ProductID、UserToken等信息；c) 業(yè)務(wù)管理平臺(tái)根據(jù)產(chǎn)品、用戶信息進(jìn)行業(yè)務(wù)鑒權(quán)；d) 業(yè)務(wù)管理平臺(tái)通過SOAP響應(yīng)返回鑒權(quán)結(jié)果；e) 如果鑒權(quán)未通過，則業(yè)務(wù)系統(tǒng)發(fā)起業(yè)務(wù)訂購的流程；f) 如果鑒權(quán)通過，則業(yè)務(wù)系統(tǒng)允許使用；g) 業(yè)務(wù)系統(tǒng)返回用戶請求的實(shí)際業(yè)務(wù)內(nèi)容，繼續(xù)業(yè)務(wù)的使用。5.5.2 接口協(xié)議內(nèi)容承載協(xié)議：SOAP接口方向：業(yè)務(wù)系統(tǒng) 業(yè)務(wù)管理平臺(tái)接口功能：業(yè)務(wù)系統(tǒng)向業(yè)務(wù)管理平臺(tái)請求使用業(yè)務(wù)表5-4-2-1：業(yè)務(wù)鑒權(quán)請求ServiceAuthReq 名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選SPID增值業(yè)務(wù)SP的編號(hào)，基本業(yè)務(wù)鑒權(quán)時(shí)無效String8OUserID用戶登錄業(yè)務(wù)帳號(hào)String36OUserToken業(yè)務(wù)管理平臺(tái)為該用戶分配的臨時(shí)身份證明，這里通過EPG上傳給業(yè)務(wù)管理平臺(tái)String32MProductIDIPTV產(chǎn)品編號(hào)String32MServiceIDIPTV服務(wù)編號(hào)String32OContentIDIPTV內(nèi)容編號(hào)String32MTimeStamp從1970年1月1日0時(shí)開始的毫秒數(shù)digit string=18MIPIP地址String39OMAC機(jī)頂盒的MAC地址，格式為：xx:xx:xx:xx:xx:xxString17OTransactionID事務(wù)編號(hào)string40O表5-4-2-2：業(yè)務(wù)鑒權(quán)請求響應(yīng)名稱說 明數(shù)據(jù)類型長度（字節(jié)）是否必選Result0：成功其他：失敗String4MUserID用戶登錄業(yè)務(wù)帳號(hào)String36OProductID產(chǎn)品IDString32MServiceID服務(wù)IDString32O ContentID內(nèi)容IDString32M STBID機(jī)頂盒IDstring32OIPIP地址string39OMAC機(jī)頂盒的MAC地址，格式為：xx:xx:xx:xx:xx:xxstring17OTransactionID事務(wù)編號(hào)string40OExpiredTime本訂購關(guān)系的鑒權(quán)失效時(shí)間，用絕對時(shí)間表示。格式為：YYYYMMDDhhmmss。如本參數(shù)為空，則表示該訂購關(guān)系的鑒權(quán)長期有效；如本參數(shù)為當(dāng)前時(shí)間，則表示該訂購關(guān)系的鑒權(quán)一次性有效。String14OBalance預(yù)付費(fèi)用戶余額，單位為分。如為后付費(fèi)用戶，該參數(shù)缺失或?yàn)榭読nt4OProductList可訂購的產(chǎn)品列表，在訂購失敗并返回“用戶未訂購”的情況下攜帶該參數(shù)。Product不定O表5-4-2-2：Product 結(jié)構(gòu)名稱說 明數(shù)據(jù)類型長度（字節(jié)）是否必選ProductID產(chǎn)品IDString32MProductName產(chǎn)品名稱String100MFee產(chǎn)品價(jià)格，以分為單位Int4MPurchaseType0：包月支付，用戶選擇訂購產(chǎn)品后，按照固定包月費(fèi)用計(jì)費(fèi)，在當(dāng)月內(nèi)無需再次向業(yè)務(wù)管理平臺(tái)發(fā)起訂購請求；1：按次支付，用戶選擇訂購產(chǎn)品后，按照使用次數(shù)進(jìn)行計(jì)費(fèi)無需重新發(fā)起訂購請求2：免費(fèi)3：ppv，用戶選擇訂購產(chǎn)品后，進(jìn)行一次性計(jì)費(fèi)。再次使用時(shí)仍需訂購該產(chǎn)品4：SVOD；5：PVOD；Int4OProductDesc產(chǎn)品描述String200OListPrice標(biāo)稱價(jià)格，以分為單位Int4ORentalTerm租期Int4OLimitTimes可使用次數(shù)Int4O5.6 業(yè)務(wù)訂購5.6.1 接口時(shí)序STB業(yè)務(wù)系統(tǒng)業(yè)務(wù)管理平臺(tái)a）訂購請求b）業(yè)務(wù)訂購請求c）返回訂購響應(yīng)e）返回處理頁面d）保存訂購信息圖5-5-1-1：即時(shí)業(yè)務(wù)訂購流程圖5.6.2 接口協(xié)議內(nèi)容承載協(xié)議：SOAP接口方向：EPG服務(wù)系統(tǒng) 業(yè)務(wù)管理平臺(tái)接口功能：用戶訂購業(yè)務(wù)請求消息包含以下關(guān)鍵參數(shù)表5-5-2-1：業(yè)務(wù)訂購請求參數(shù)名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選SPIDSP的唯一標(biāo)識(shí)string8OUserIDIPTV用戶業(yè)務(wù)編號(hào)string36OUserToken業(yè)務(wù)管理平臺(tái)為該用戶分配的臨時(shí)身份證明，可采用Cookie的方式傳遞string32MContentID內(nèi)容IDstring32MServiceIDIPTV服務(wù)編號(hào)string32OProductIDIPTV產(chǎn)品編號(hào)string32MAction操作類型：1：表示訂購；2：表示退訂。String20M業(yè)務(wù)管理平臺(tái)返回的響應(yīng)消息攜帶以下參數(shù)：表5-5-2-2：SOAP響應(yīng)消息名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Result業(yè)務(wù)訂購結(jié)果 0：成功 其他：失敗String4MDescription結(jié)果描述String256OUserIDIPTV用戶業(yè)務(wù)編號(hào)string36OUserToken業(yè)務(wù)管理平臺(tái)為該用戶分配的臨時(shí)身份證明，可采用Cookie的方式傳遞string32OContentID內(nèi)容IDstring32M ServiceIDIPTV服務(wù)編號(hào)string32OProductIDIPTV產(chǎn)品編號(hào)string32MSPIDSP的唯一標(biāo)識(shí)string8OTransactionID訂購的事務(wù)編號(hào)string40OExpiredTime訂購關(guān)系的失效時(shí)間， 格 式 為YYYYMMDDhhmmss。缺少該參數(shù)表示永久有效。String14OBalance預(yù)付費(fèi)用戶的費(fèi)用余額，單位為分。如為后付費(fèi)用戶，該參數(shù)缺失或?yàn)榭铡nt4OFee產(chǎn)品價(jià)格，以分為單位Int4MPurchaseType0：包月支付，用戶選擇訂購產(chǎn)品后，按照固定包月費(fèi)用計(jì)費(fèi)，在當(dāng)月內(nèi)無需再次向業(yè)務(wù)管理平臺(tái)發(fā)起訂購請求；1：按次支付，用戶選擇訂購產(chǎn)品后，按照使用次數(shù)進(jìn)行計(jì)費(fèi)無需重新發(fā)起訂購請求2：免費(fèi)3：ppv，用戶選擇訂購產(chǎn)品后，進(jìn)行一次性計(jì)費(fèi)。再次使用時(shí)仍需訂購該產(chǎn)品4：SVOD5：PVODInt4O5.7 直播頻道列表更新接口5.7.1 接口時(shí)序STBEPG服務(wù)系統(tǒng)業(yè)務(wù)管理平臺(tái)a)直播頻道成功訂購流程b)重定向，設(shè)置新的頻道列表c)頻道更新響應(yīng)圖5-6-1-1：直播頻道列表更新流程圖a) STB通過業(yè)務(wù)訂購接口完成對于直播頻道的訂購，并通過直播訂購接口步驟 7 返回訂購成功的響應(yīng)。b) EPG服務(wù)系統(tǒng)將用戶重定向至業(yè)務(wù)管理平臺(tái)，要求重新設(shè)置直播頻道列表。c) 業(yè)務(wù)管理平臺(tái)通過CTCSetConfig設(shè)置訂購成功的頻道列表，并將機(jī)頂盒重定向至EPG服務(wù)系統(tǒng)。5.7.2 接口協(xié)議內(nèi)容承載協(xié)議：HTTP GET接口方向：EPG服務(wù)系統(tǒng)重定向 業(yè)務(wù)管理平臺(tái)接口功能：直播頻道訂購成功后，對直播頻道列表進(jìn)行更新請求消息包含以下關(guān)鍵參數(shù)表5-6-2-1：更新直播頻道列表請求參數(shù)說明名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選SPIDSP的唯一標(biāo)識(shí)String8OUserIDIPTV用戶業(yè)務(wù)編號(hào)string36MReturnURL更新UserToken后返回的URL，采用URLEncoding的ANSI方式string256MAction操作類型，此處使用：“ChannelListUpdate”String20MChannelIDList需要更新的頻道列表，采用”|”分隔的頻道ID列表，如134|123|335String256M業(yè)務(wù)管理系統(tǒng)重定向返回，通過URL參數(shù)攜帶以下信息表5-6-2-2：更新直播頻道列表返回參數(shù)說明名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選SPIDSP的唯一標(biāo)識(shí)String8OUserIDIPTV用戶業(yè)務(wù)編號(hào)string36MResult更新結(jié)果 0：成功 其他：失敗String4M5.8 產(chǎn)品包信息獲取接口業(yè)務(wù)管理平臺(tái)EPG服務(wù)系統(tǒng)a）產(chǎn)品包獲取請求b）產(chǎn)品包獲取響應(yīng)5.8.1 接口時(shí)序圖5-7-1-1：產(chǎn)品包信息獲取流程圖5.8.2 接口協(xié)議內(nèi)容承載協(xié)議：SOAP接口方向：EPG服務(wù)系統(tǒng) 業(yè)務(wù)管理平臺(tái)接口功能：EPG服務(wù)系統(tǒng)從業(yè)務(wù)管理平臺(tái)獲取產(chǎn)品包信息。SOAP接口請求消息ProInfo不包含任何信息。SOAP接口響應(yīng)消息ProInfoResponse，需要包含以下信息：表5-7-2-1：響應(yīng)ProInfoResponse名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ProductAmount產(chǎn)品數(shù)量Int4MProduct產(chǎn)品列表Product見表5-6-2-2Product說明M表5-7-2-2： Product說明名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ProductIDIPTV產(chǎn)品編號(hào)String32MServiceAmount服務(wù)數(shù)量Int4MService服務(wù)列表Service見表5-7-2-3Service說明M表5-7-2-3： Service說明名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ServiceIDIPTV服務(wù)編號(hào)string32M5.9 增值業(yè)務(wù)認(rèn)證鑒權(quán)STB增值業(yè)務(wù)系統(tǒng)業(yè)務(wù)管理平臺(tái)a）首次訪問b）SSO獲取用戶身份c）查詢增值業(yè)務(wù)訂購信息f）增值業(yè)務(wù)鑒權(quán)d）增值業(yè)務(wù)訪問g）業(yè)務(wù)使用e）業(yè)務(wù)訂購圖5-9-1：即時(shí)業(yè)務(wù)訂購流程圖a) 用戶首次訪問增值業(yè)務(wù)系統(tǒng)；b) 增值業(yè)務(wù)系統(tǒng)通過SSO過程獲取用戶身份，參見5.7.1；c) 增值業(yè)務(wù)系統(tǒng)查詢增值業(yè)務(wù)訂購信息，參見5.7.2；d) 用戶進(jìn)行增值業(yè)務(wù)訪問；e) 如用戶未訂購業(yè)務(wù)，則要求用戶進(jìn)行訂購，參見5.5；f) 增值業(yè)務(wù)系統(tǒng)進(jìn)行業(yè)務(wù)鑒權(quán)，參見5.4；g) 用戶使用增值業(yè)務(wù)。5.9.1 用戶身份重定向（SSO） 接口時(shí)序STB增值業(yè)務(wù)系統(tǒng)業(yè)務(wù)管理平臺(tái)a）業(yè)務(wù)請求b）檢測到UserTokenc）請求響應(yīng)d）未檢測到UserTokene）HTTP重定向f）SSO返回新的UserToken圖5-9-1-1-1：重定向認(rèn)證用戶身份流程在用戶首次訪問增值業(yè)務(wù)系統(tǒng)無法判斷用戶身份時(shí)，使用該SSO重定向過程獲取UserToken以判定用戶身份：a) 用戶訪問增值業(yè)務(wù)系統(tǒng)/IPTV業(yè)務(wù)系統(tǒng)；b) 增值業(yè)務(wù)系統(tǒng)檢測UserToken；c) 如增值業(yè)務(wù)系統(tǒng)檢測到合法UserToken，則返回正常使用響應(yīng)；d) 增值業(yè)務(wù)系統(tǒng)無法獲取UserToken，則開始重定向過程；e) 增值業(yè)務(wù)系統(tǒng)將用戶重定向到業(yè)務(wù)管理平臺(tái)，攜帶ReturnURL等參數(shù)；f) 業(yè)務(wù)管理平臺(tái)檢查用戶cookie獲取UserToken，如果沒有檢測到，通過重新認(rèn)證產(chǎn)生UserToken（參見5.3），并通過重定向參數(shù)方式，將UserToken等參數(shù)返回給增值業(yè)務(wù)系統(tǒng)。 接口協(xié)議內(nèi)容承載協(xié)議：SSO接口方向：增值業(yè)務(wù)系統(tǒng) 業(yè)務(wù)管理平臺(tái)接口功能：在用戶首次訪問增值業(yè)務(wù)系統(tǒng)無法判斷用戶身份時(shí)，使用該SSO重定向過程獲取UserToken以判定用戶身份。請求消息包含以下參數(shù)表5-9-1-2-1：業(yè)務(wù)身份重定向請求參數(shù)名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選SPIDSP的唯一標(biāo)識(shí)string8MReturnURL返回增值業(yè)務(wù)系統(tǒng)頁面的URLstring256MReturnInfo返回增值業(yè)務(wù)系統(tǒng)頁面需要攜帶的額外信息，可用于區(qū)分不同的SSO請求String256OAction操作類型，此處使用：UserTokenRequestString20M用戶身份獲取后，業(yè)務(wù)管理系統(tǒng)重定向返回，通過URL參數(shù)攜帶以下信息：表5-9-1-2-2 關(guān)鍵信息名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選SPIDSP的唯一標(biāo)識(shí)string8OUserIDIPTV用戶業(yè)務(wù)編號(hào)string36OEPGGroupNMB用戶對應(yīng)的EPG分組信息標(biāo)識(shí)string8OUserGroupNMB用戶對應(yīng)的分組信息標(biāo)識(shí)string8OResult身份獲取結(jié)果 0：成功 其他：失敗String4MDescription結(jié)果描述String256OUserTokenIPTV用戶業(yè)務(wù)編號(hào)string36MExpiredTimeUserToken的失效時(shí)間， 格 式 為YYYYMMDDhhmmss。缺少在一次開機(jī)過程中該參數(shù)表示永久有效。String14OReturnInfo返回增值業(yè)務(wù)系統(tǒng)頁面需要攜帶的額外信息，可用于區(qū)分不同的SSO請求String256O5.9.2 增值業(yè)務(wù)訂購查詢接口承載協(xié)議：SOAP接口方向：增值業(yè)務(wù)系統(tǒng) 業(yè)務(wù)管理平臺(tái)接口功能：增值業(yè)務(wù)平臺(tái)向業(yè)務(wù)管理平臺(tái)請求查詢用戶訂購過的所有產(chǎn)品信息。表5-9-2-1 增值業(yè)務(wù)產(chǎn)品訂購查詢請求參數(shù)名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選UserToken業(yè)務(wù)管理平臺(tái)為該用戶分配的臨時(shí)身份證明String32MUserID用戶登錄業(yè)務(wù)帳號(hào)String36OSPID增值業(yè)務(wù)SP的編號(hào)，如為空，則查詢所有SP的產(chǎn)品訂購信息String8O表5-9-2-2 增值業(yè)務(wù)產(chǎn)品訂購查詢請求響應(yīng)名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選UserID用戶登錄業(yè)務(wù)帳號(hào)String36MEPGGroupNMB用戶對應(yīng)的EPG分組信息標(biāo)識(shí)String8MSTBID機(jī)頂盒ID，詳見第6章String32OMAC機(jī)頂盒的MAC地址，格式為：xx:xx:xx:xx:xx:xxString17OProducts用戶已購買的增值業(yè)務(wù)IPTV產(chǎn)品編號(hào)，多個(gè)用”,”分隔String255OSPID增值業(yè)務(wù)SP的編號(hào)，如為空，則查詢所有SP的產(chǎn)品訂購信息String8O5.9.3 增值業(yè)務(wù)產(chǎn)品詳細(xì)查詢承載協(xié)議：SOAP接口方向：增值業(yè)務(wù)系統(tǒng) 業(yè)務(wù)管理平臺(tái)接口功能：增值業(yè)務(wù)系統(tǒng)向業(yè)務(wù)管理平臺(tái)請求查詢用戶訂購過的產(chǎn)品詳細(xì)信息。表5-9-3-1 查詢產(chǎn)品詳細(xì)信息請求ProdDetailQueryReq名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ProductID產(chǎn)品IDString32MSPID增值業(yè)務(wù)SP的編號(hào)String8O表5-8-3-2 查詢產(chǎn)品詳細(xì)信息請求響應(yīng)名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ProductID產(chǎn)品IDString32MProductName產(chǎn)品名String100MProductDesc產(chǎn)品描述String200OPurchaseType0：包月支付，用戶選擇訂購產(chǎn)品后，按照固定包月費(fèi)用計(jì)費(fèi)，在當(dāng)月內(nèi)無需再次向業(yè)務(wù)管理平臺(tái)發(fā)起訂購請求；1：按次支付，用戶選擇訂購產(chǎn)品后，按照使用次數(shù)進(jìn)行計(jì)費(fèi)無需重新發(fā)起訂購請求2：免費(fèi)int4OFee支付金額(以分為單位)int4OEPGGroupNMB產(chǎn)品使用的EPG分組String8O5.9.4 業(yè)務(wù)訂購 接口流程STB增值業(yè)務(wù)系統(tǒng)業(yè)務(wù)管理平臺(tái)a）http請求f）返回處理結(jié)果c）業(yè)務(wù)訂購請求b）重定向d）返回業(yè)務(wù)訂購確認(rèn)頁面e）確認(rèn)訂購g）保存訂購信息h）返回處理頁面圖5-9-4-1-1：即時(shí)業(yè)務(wù)訂購流程圖 接口協(xié)議內(nèi)容承載協(xié)議：HTTP GET接口方向：增值業(yè)務(wù)系統(tǒng)重定向 業(yè)務(wù)管理平臺(tái)接口功能：用戶訂購業(yè)務(wù)請求消息包含以下關(guān)鍵參數(shù)表5-9-4-2-1：業(yè)務(wù)訂購請求參數(shù)名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選SPIDSP 的唯一標(biāo)識(shí)String8MUserIDIPTV 用戶業(yè)務(wù)編號(hào)String36OContentIDIPTV內(nèi)容IDstring32OServiceIDIPTV 服務(wù)編號(hào)String32MProductIDIPTV 產(chǎn)品編號(hào)String32MUserToken業(yè)務(wù)管理平臺(tái)為該用戶分配的臨時(shí)身份證明，可采用Cookie 的方式傳遞String32MReturnURL返回EPG 服務(wù)頁面的URLString256MAction操作類型：1：表示訂購；2：表示退訂。String20M訂購成功或取消訂購結(jié)束后，業(yè)務(wù)管理系統(tǒng)重定向返回增值服務(wù)系統(tǒng)，通過URL 參數(shù)攜帶以下信息：表5-9-4-2-2：關(guān)鍵信息名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Result業(yè)務(wù)訂購結(jié)果 0：成功 其他：失敗String4MDescription結(jié)果描述String256OUserIDIPTV用戶業(yè)務(wù)編號(hào)string36OUserToken業(yè)務(wù)管理平臺(tái)為該用戶分配的臨時(shí)身份證明，可采用Cookie的方式傳遞string32OContentID內(nèi)容IDstring32OServiceIDIPTV服務(wù)編號(hào)string32MProductIDIPTV產(chǎn)品編號(hào)string32MProductNameIPTV 產(chǎn)品名稱String100OPurchaseType0：包月支付，用戶選擇訂購產(chǎn)品后，按照固定包月費(fèi)用計(jì)費(fèi)，在當(dāng)月內(nèi)無需再次向業(yè)務(wù)管理平臺(tái)發(fā)起訂購請求；1：按次支付，用戶選擇訂購產(chǎn)品后，按照使用次數(shù)進(jìn)行計(jì)費(fèi)無需重新發(fā)起訂購請求2：免費(fèi)Int4OFee產(chǎn)品價(jià)格，以分為單位Int4MSPIDSP的唯一標(biāo)識(shí)string8OTransactionID訂購的事務(wù)編號(hào)string40OExpiredTime訂購關(guān)系的失效時(shí)間， 格 式 為YYYYMMDDhhmmss。缺少該參數(shù)表示永久有效。String14O5.10 業(yè)務(wù)能力系統(tǒng)數(shù)據(jù)采集接口5.10.1 采集要求表5-10-1-1 數(shù)據(jù)采集要求采集周期：每天采集數(shù)據(jù)形式：以文本文件存放文件命名：以“