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

1、文件編號：SHDX/ZS/CZ/JG02A/2OO8中國電信集團(tuán)上海市電信公司IPTV業(yè)務(wù)管理平臺與業(yè)務(wù)系統(tǒng)接口技術(shù)規(guī)范V2.21目的本規(guī)范是在中國電信集團(tuán)公司發(fā)布的 IPTV業(yè)務(wù)管理平臺與業(yè)務(wù) 系統(tǒng)接口技術(shù)規(guī)范 V2.0的基礎(chǔ)上，根據(jù)中國電信上海公司 IPTV運(yùn) 營的實(shí)際情況，進(jìn)一步調(diào)整修訂而成的。本規(guī)范供引入IPTV能力平臺設(shè)備、IPTV業(yè)務(wù)管理平臺設(shè)備時(shí)參 照執(zhí)行。本技術(shù)規(guī)范的增補(bǔ)、修訂和解釋權(quán)歸中國電信上海公司所有。 如 中國電信上海公司在此之前的文件與本技術(shù)規(guī)范有矛盾， 按此技術(shù)規(guī) 范執(zhí)行。本技術(shù)規(guī)范自發(fā)布之日起實(shí)施。2適用范圍本規(guī)范規(guī)定了 IPTV業(yè)務(wù)管理平臺與業(yè)務(wù)系統(tǒng)之間的接口。

2、本規(guī)范適用于IPTV業(yè)務(wù)管理平臺、EPG服務(wù)系統(tǒng)、內(nèi)容分發(fā)系統(tǒng)之間的 接口開發(fā)。為中國電信上海公司IPTV機(jī)頂盒和平臺的接口開放的測 試提供依據(jù)。為中國電信上海公司IPTV能力平臺設(shè)備、IPTV業(yè)務(wù)管 理平臺設(shè)備的選擇提供了依據(jù)。3 引用文件 / 標(biāo)準(zhǔn)下列文件中的條款通過本標(biāo)準(zhǔn)的引用而成為本標(biāo)準(zhǔn)的條款。凡 是注日期的引用文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或 修訂版均不適用于本標(biāo)準(zhǔn)， 然而，鼓勵根據(jù)本標(biāo)準(zhǔn)達(dá)成協(xié)議的各方研 究是否可使用這些文件的最新版本。 凡是不注日期的引用文件， 其最 新版本適用于本標(biāo)準(zhǔn)。RFC2616: Hypertext Transfer ProtocolRFC3

3、275: Extensible Makeup LanguageW3C: Web Services Description LanguageIPTV業(yè)務(wù)管理平臺技術(shù)規(guī)范4 定義 /術(shù)語HTTPHypertext Transfer ProtocolIPInternet ProtocolMACMedia Access ControlEPG Electronic Programmer Guide電子節(jié)目單SOAPSimple Object Access Protocol簡單對象訪問協(xié)議STBSet Top Box機(jī)頂盒URL Uniform Resource Locator統(tǒng)一資源定位符超文本傳輸協(xié)議

4、 網(wǎng)絡(luò)協(xié)議 媒體訪問控制層5 IPT V業(yè)務(wù)管理平臺與業(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ù)管理平臺與業(yè)務(wù)系統(tǒng)的總體框架如圖所示：圖5-1-1： IPTV業(yè)務(wù)管理平臺與業(yè)務(wù)系統(tǒng)框架圖IPTV業(yè)務(wù)管理平臺與業(yè)務(wù)系統(tǒng)接口包括以下接口：a) EPG首頁鑒權(quán)接口接口描述：本接口在用戶訪問EPG首頁時(shí)，EPG服務(wù)系統(tǒng)向業(yè) 務(wù)管理平臺請求鑒權(quán)。承載協(xié)議：SOAPb) UserToken更新接口接口描述：本接口在用戶令牌UserToke(參見機(jī)頂盒與IPTV 業(yè)務(wù)運(yùn)營平臺接口技術(shù)規(guī)范)失效時(shí)，EPG服務(wù)系統(tǒng)重定向到業(yè) 務(wù)管理平

5、臺請求新的UserToken承載協(xié)議：HTTPc) Session丟失后獲取接口接口描述：本接口機(jī)頂盒訪問EPG平臺時(shí)，EPG平臺通過Session(或cookie)記憶用戶的臨時(shí)身份憑證 (UserToker)。但是， 由于Sessior (或Cookie)的時(shí)限性，使得機(jī)頂盒在一段時(shí)間內(nèi)沒 有訪問EPG頁面時(shí)，機(jī)頂盒將丟失與EPG之間的Session從而使 得EPG丟失用戶的UserToker無法繼續(xù)為該用戶機(jī)頂盒提供IPTV 服務(wù)。承載協(xié)議： HTTPd) 業(yè)務(wù)鑒權(quán)接口接口描述：本接口在用戶通過EPG請求業(yè)務(wù)資源時(shí)，EPG服務(wù) 系統(tǒng)向業(yè)務(wù)管理平臺請求業(yè)務(wù)鑒權(quán)，業(yè)務(wù)管理平臺將鑒權(quán)結(jié)果返 回

6、給EPG服務(wù)系統(tǒng)。承載協(xié)議： SOAPe) 業(yè)務(wù)訂購接口接口描述：本接口在用戶請求使用業(yè)務(wù)時(shí)，EPG服務(wù)系統(tǒng)向業(yè) 務(wù)管理平臺請求業(yè)務(wù)訂購，用戶完成訂購后， EPG 服務(wù)系統(tǒng)保存 訂購信息，再返回處理頁面給用戶。承載協(xié)議： SOAPf) 直播頻道列表更新接口接口描述： 本接口在用戶請求訂購直播頻道， 當(dāng)業(yè)務(wù)管理平臺 返回訂購成功響應(yīng)后，EPG服務(wù)系統(tǒng)將用戶重定向至業(yè)務(wù)管理平 臺，要求重新設(shè)置直播頻道列表。 業(yè)務(wù)管理平臺通過 CTCSetCorfig 設(shè)置訂購成功的頻道列表，并將機(jī)頂盒重定向至EPG服務(wù)系統(tǒng)。承載協(xié)議： HTTPg) 產(chǎn)品包信息獲取接口 接口描述：本接口為 EPG 服務(wù)系統(tǒng)向業(yè)務(wù)管

7、理平臺請求產(chǎn)品 包信息，業(yè)務(wù)管理系統(tǒng)將產(chǎn)品包信息返回給 EPG服務(wù)系統(tǒng)。 承載協(xié)議： SOAPh) 用戶身份重定向接口接口描述：本接口在用戶請求使用業(yè)務(wù)時(shí)，接收到 HTTP重定向命令，要求重定向到業(yè)務(wù)管理平臺的業(yè)務(wù)訂購頁面時(shí)觸發(fā)，用 戶完成訂購后， EPG 服務(wù)系統(tǒng)保存訂購信息，再返回處理頁面給 用戶。承載協(xié)議： HTTPi) 增值業(yè)務(wù)訂購查詢接口接口描述：增值業(yè)務(wù)平臺向業(yè)務(wù)管理平臺請求查詢用戶訂購過 的所有產(chǎn)品信息。承載協(xié)議： SOAPj) 增值業(yè)務(wù)產(chǎn)品詳細(xì)信息查詢接口接口描述：增值業(yè)務(wù)平臺向業(yè)務(wù)管理平臺請求查詢用戶訂購過 的產(chǎn)品詳細(xì)信息。承載協(xié)議： SOAPk) 增值業(yè)務(wù)產(chǎn)品訂購接口接口描

8、述： 當(dāng)用戶選擇訂購某增值業(yè)務(wù)時(shí)， 增值業(yè)務(wù)平臺將用戶重定向至業(yè)務(wù)管理平臺進(jìn)行該增值業(yè)務(wù)的訂購。當(dāng)用戶訂購成 功后，業(yè)務(wù)管理平臺能將用戶重定向回增值業(yè)務(wù)平臺顯示訂購結(jié)承載協(xié)議：HTTPI）業(yè)務(wù)能力系統(tǒng)數(shù)據(jù)采集接口接口描述：為了進(jìn)行IPT V業(yè)務(wù)的經(jīng)營分析需要向IPTV平臺采集相關(guān)數(shù)據(jù)。承載協(xié)議：FTP（【注】當(dāng)業(yè)務(wù)能力平臺、增值業(yè)務(wù)系統(tǒng)與業(yè)務(wù)管理平臺進(jìn)行橫向SOAP接口進(jìn)行交互時(shí)，能夠?qū)M向接口連接情況進(jìn)行監(jiān)測，并在橫 向接口連接時(shí)間超過10s的情況下通過錯誤提示頁面告知用戶，并要 求機(jī)頂盒重新發(fā)起認(rèn)證請求。）5.2 EPG首頁鑒權(quán)接口接口時(shí)序圖5-2-1-1 : EPG首頁鑒權(quán)流程接口協(xié)議內(nèi)

9、容承載協(xié)議：SOAP接口方向：:EPG服務(wù)系統(tǒng) -業(yè)務(wù)管理平臺接口功能：EPG服務(wù)系統(tǒng)向業(yè)務(wù)管理平臺請求鑒權(quán)，通過鑒 權(quán)后再給用戶下發(fā)EPG首頁SOAP接口請求消息EPGAuth包含如下信息:表 5-2-2-1 :請求 EPGAuth名稱說明數(shù)據(jù)長度是否類型（字節(jié)）必選UserToken業(yè)務(wù)管理平臺為該用戶分配的臨時(shí)身 份證明Stri ng32MSOAP接 口應(yīng)答消息EPGAuthRespons包含以下信息:表 5-2-2-2 :響應(yīng) EPGAuthResponse名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選UserIDIPTV用戶業(yè)務(wù)編號Stri ng36MResult結(jié)果，0:成功其他：失敗

10、Stri ng4MDescriptio n結(jié)果描述Stri ng256OUserGroupNMB用戶對應(yīng)的用戶分組信息標(biāo)識Stri ng8OEPGGroupNMB用戶對應(yīng)的EPG分組信息標(biāo)識Stri ng8MSTBID機(jī)頂盒編號stri ng32OMAC機(jī)頂盒的MAC地址，格式為：xx:xx:xx:xx:xx:xxStri ng13OProducts用戶已購買的IPTV產(chǎn)品編號組合，組 合間采用”分隔，組合內(nèi)采用”分隔， 分別為產(chǎn)品ID,內(nèi)容ID,可以為以下 情形：1、ProductID :表示整個(gè)產(chǎn)品的訂購關(guān)Stri ng不定O系，且有效期未知；2、ProductlD,ExpiredTime

11、 :表示整個(gè)產(chǎn)品的訂購關(guān)系，且存在有效期；3、ProductlD,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)系。Toke nExpiredTimeUserToken的失效時(shí)間，格式為：YYYYMMDDhhmmss。缺少該參數(shù)表示 在一次登錄期間，永久有效。Stri ng14O5.3 User

12、Token更新接口 接口時(shí)序圖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ù)管理平臺，請求新的UserToken 請求參數(shù) ReturnURL,OldUserToken Action。f）如業(yè)務(wù)管理平臺需要STB重新認(rèn)證或發(fā)生頻道更改需要更新頻 道列表，則下發(fā)重認(rèn)證頁面或頻道更新頁面；g）STB重新認(rèn)證或更新頻

13、道結(jié)束后，由頁面邏輯控制發(fā)起重定向 請求；h）業(yè)務(wù)管理平臺返回新的UserToken返回參數(shù)NewUserToken Result（【注】：IPTV業(yè)務(wù)能力平臺在完成用戶UserToken更新后都應(yīng)該再次 發(fā)起首頁鑒權(quán)請求，以保證當(dāng)前用戶已訂購產(chǎn)品列表為最新且可用 的。）接口協(xié)議內(nèi)容承載協(xié)議：HTTP GET接口方向：FepgB務(wù)系統(tǒng)重定向 -業(yè)務(wù)管理平臺接口功能：UserToken失效時(shí)，EPG服務(wù)系統(tǒng)重定向到業(yè)務(wù)管 理平臺請求新的UserToken請求消息包含以下關(guān)鍵參數(shù)表5-3-2-1 :更新UserToken請求參數(shù)說明名稱說明數(shù)據(jù)長度是否類型（字節(jié)）必選SPIDSP的唯一標(biāo)識Stri

14、 ng8OUserIDIPTV用戶業(yè)務(wù)編號stri ng36OOldUserToke n過期的UserTokenStri ng32MReturnURL更新UserToken后返回的 URL,米用stri ng256MURLEncoding 的 ANSI 方式Actio n操作類型，此處使用：“ UserTokenExpired”Stri ng20M響應(yīng)消息表5-3-2-2 :更新UserToken返回參數(shù)說明名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選SPIDSP的唯一標(biāo)識Stri ng8OUserIDIPTV用戶業(yè)務(wù)編號stri ng36MNewUserToke n新的 UserTokenSt

15、ri ng32MResult更新結(jié)果0 :成功其他：失敗Stri ng4MToke nExpiredTimeUserToken的失效時(shí)間，格式為：YYYYMMDDhhmmss缺少該參數(shù)表示永久有效。Stri ng14O5.4 Session丟失后獲取接口機(jī)頂盒訪問EPG平臺時(shí)，EPG平臺通過Session （或cookie）記憶 用戶的臨時(shí)身份憑證（UserToken。但是，由于Session （或Cookie） 的時(shí)限性，使得機(jī)頂盒在一段時(shí)間內(nèi)沒有訪問 EPG頁面時(shí)，機(jī)頂盒將 丟失與EPG之間的Session從而使得EPG丟失用戶的UserToken無 法繼續(xù)為該用戶機(jī)頂盒提供IPTV服務(wù)。

16、5.4.1 接口時(shí)序?yàn)榱私鉀Q這一問題，可以采用SSO流程獲取用戶的UserToken以下是機(jī)頂盒與EPG交互、Session丟失和EPG處理流程：a) .機(jī)頂盒開機(jī)認(rèn)證通過，業(yè)務(wù)管理平臺為其分配臨時(shí)身份憑證UserToke nb) .機(jī)頂盒訪問EPG首頁，攜帶UserTokenc) . EPG以 Session (或 Cookie)方式保存用戶的 UserTokend) . EPG在調(diào)用業(yè)務(wù)管理平臺的業(yè)務(wù)鑒權(quán)、 產(chǎn)品訂購時(shí)必需攜帶有效的UserTokenEPG通過UserToken更新機(jī)制來保證UserToken 的有效性。e) .機(jī)頂盒通過訪問EPG頁面來維持機(jī)頂盒與 EPG之間的Sessi

17、on有效。機(jī)頂盒在一段時(shí)間內(nèi)沒有操作或者機(jī)頂盒離開 EPG訪問 增值業(yè)務(wù)，超過Session的超時(shí)時(shí)限，機(jī)頂盒丟失與 EPG之間 的 Sessionf) .機(jī)頂盒再次訪問EPG EPG因Session丟失，無法獲得機(jī)頂盒的 UserTokeng) . EPG系統(tǒng)將機(jī)頂盒重定向到業(yè)務(wù)管理系統(tǒng)，發(fā)起用戶身份重定向SSO請求，攜帶ReturnURL等參數(shù)h) .業(yè)務(wù)管理平臺獲取機(jī)頂盒的 UserToker后，通過通過重定向攜帶參數(shù)方式，將UserToken等參數(shù)返回給EPG系統(tǒng)i) . EPG獲得用戶身份，繼續(xù)為用戶提供服務(wù)。接口協(xié)議內(nèi)容承載協(xié)議HTTP SSO接口方向EPG服務(wù)系統(tǒng) f 業(yè)務(wù)管理平

18、臺接口功能米用SSO流程獲取用戶的UserToken業(yè)務(wù)身份重定向SSO#求參數(shù):表5-4-2-1 :業(yè)務(wù)身份重定向SSO請求參數(shù)說明名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選SPIDSP勺唯一標(biāo)識stri ng8MReturnURL返回增值業(yè)務(wù)系統(tǒng)頁面的 URLstri ng256MReturnl nfo返回增值業(yè)務(wù)系統(tǒng)頁面需要攜帶的額外信 息，可用于區(qū)分不冋的 SSO青求stri ng256OActio n操作類型，此處使用：UserToke nRequeststri ng20M業(yè)務(wù)身份重定向SSOS回參數(shù):表5-4-2-2 :業(yè)務(wù)身份重定向SSO向應(yīng)參數(shù)說明名稱說明數(shù)據(jù) 類型長度（字節(jié)）

19、是否 必選Result身份獲取結(jié)果0:成功；其他：失敗stri ng4MUserTokenIPTV用戶業(yè)務(wù)編號stri ng36MSPIDSP勺唯一標(biāo)識stri ng8OUserIDIPTV用戶業(yè)務(wù)編號stri ng36OEPGGroupNMB用戶對應(yīng)的EPG分組信息標(biāo)識stri ng8OUserGroupNMB用戶對應(yīng)的分組信息標(biāo)識stri ng8ODescripti on結(jié)果描述stri ng256OExpiredTimeUserToken的失效時(shí)間，格式為YYYYMMDDhhmmss缺少在一次開機(jī)過程中該參數(shù)表示永久有效。stri ng14OReturnI nfo返回EPG頁面需要攜帶的

20、額外信息，可用stri ng256O于區(qū)分不同的SSO青求5.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ù)管理平臺的SOAP請求，攜帶ProductID、UserToken等信息；c）業(yè)務(wù)管理平臺根據(jù)產(chǎn)品、用戶信息進(jìn)行業(yè)務(wù)鑒權(quán)；d）業(yè)務(wù)管理平臺通過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ù)的使用。接口協(xié)議內(nèi)容承載協(xié)議SOAP接口方向業(yè)務(wù)系統(tǒng)-業(yè)務(wù)

21、管理平臺接口功能業(yè)務(wù)系統(tǒng)向業(yè)務(wù)管理平臺請求使用業(yè)務(wù)表 5-4-2-1 :業(yè)務(wù)鑒權(quán)請求 ServiceAuthReq名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選SPID增值業(yè)務(wù)SP的編號，基本業(yè)務(wù)鑒權(quán)時(shí)無效Stri ng8OUserID用戶登錄業(yè)務(wù)帳號Stri ng36OUserToken業(yè)務(wù)管理平臺為該用戶分配的臨時(shí)身份證Stri ng32M明，這里通過EPG上傳給業(yè)務(wù)管理平臺ProductIDIPTV產(chǎn)品編號Stri ng32MServicelDIPTV服務(wù)編號Stri ng32OConten tIDIPTV內(nèi)容編號Stri ng32MTimeStamp從1970年1月1日0時(shí)開始的毫秒數(shù)di

22、git stri ng<=18MIPIP地址Stri ng39OMAC機(jī)頂盒的 MAC地址，格式為：xx:xx:xx:xx:xx:xxStri ng17OTran sact ionlD事務(wù)編號stri ng40O表5-4-2-2 :業(yè)務(wù)鑒權(quán)請求響應(yīng)名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選Result0 :成功其他：失敗Stri ng4MUserID用戶登錄業(yè)務(wù)帳號Stri ng36OProductID產(chǎn)品IDStri ng32MServiceID服務(wù)IDStri ng32OConten tID內(nèi)容IDStri ng32MSTBID機(jī)頂盒IDstri ng32OIPIP地址stri ng

23、39OMAC機(jī)頂盒的 MAC地址，格式為：xx:xx:xx:xx:xx:xxstri ng17OTran sacti onlD事務(wù)編號stri ng40OExpiredTime本訂購關(guān)系的鑒權(quán)失效時(shí)間，用絕對時(shí)間 表示。格式為： YYYYMMDDhhmmss。如本 參數(shù)為空，則表示該訂購關(guān)系的鑒權(quán)長期 有效；如本參數(shù)為當(dāng)前時(shí)間，則表示該訂 購關(guān)系的鑒權(quán)一次性有效。Stri ng14OBala nee預(yù)付費(fèi)用戶余額，單位為 分。如為后付費(fèi)用戶，該 參數(shù)缺失或?yàn)榭読nt4OProductList可訂購的產(chǎn)品列表，在訂 購失敗并返回 用戶未訂 購”的情況下攜帶該參數(shù)。Product不定O表5-4-2

24、-2: Product 結(jié)構(gòu)名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選ProductID產(chǎn)品IDStri ng32MProductName產(chǎn)品名稱Stri ng100MFee產(chǎn)品價(jià)格，以分為單位Int4MPurchaseType0:包月支付，用戶選擇訂購產(chǎn)品后，按照 固定包月費(fèi)用計(jì)費(fèi)，在當(dāng)月內(nèi)無需再次向 業(yè)務(wù)管理平臺發(fā)起訂購請求；1：按次支付，用戶選擇訂購產(chǎn)品后，按照 使用次數(shù)進(jìn)行計(jì)費(fèi)無需重新發(fā)起訂購請求Int4O2:免費(fèi)3 : ppv,用戶選擇訂購產(chǎn)品后，進(jìn)行一次 性計(jì)費(fèi)。再次使用時(shí)仍需訂購該產(chǎn)品4： SVOD5： PVOD;ProductDesc產(chǎn)品描述Stri ng200OListPri

25、ce標(biāo)稱價(jià)格，以分為單位Int4ORen talTerm租期Int4OLimitTimes可使用次數(shù)Int4O5.6業(yè)務(wù)訂購接口時(shí)序圖5-5-1-1 :即時(shí)業(yè)務(wù)訂購流程圖接口協(xié)議內(nèi)容承載協(xié)議SOAP接口方向EPG服務(wù)系統(tǒng) -業(yè)務(wù)管理平臺接口功能用戶訂購業(yè)務(wù)請求消息包含以下關(guān)鍵參數(shù)表5-5-2-1 :業(yè)務(wù)訂購請求參數(shù)名稱說明數(shù)據(jù)長度是否類型（字節(jié)）必選SPIDSP的唯一標(biāo)識stri ng8OUserIDIPTV用戶業(yè)務(wù)編號stri ng36OUserToken業(yè)務(wù)管理平臺為該用戶分配的臨時(shí)身份證明，可采用Cookie的方式傳遞stri ng32MConten tID內(nèi)容IDstri ng32MS

26、erviceIDIPTV服務(wù)編號stri ng32OProductIDIPTV產(chǎn)品編號stri ng32M操作類型：Actio n1:表示訂購；Stri ng20M2 :表示退訂。業(yè)務(wù)管理平臺返回的響應(yīng)消息攜帶以下參數(shù)表5-5-2-2: SOAR向應(yīng)消息名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選Result業(yè)務(wù)訂購結(jié)果 0 :成功其他：失敗Stri ng4MDescripti on結(jié)果描述Stri ng256OUserIDIPTV用戶業(yè)務(wù)編號stri ng36OUserToken業(yè)務(wù)管理平臺為該用戶分配的臨時(shí)身份證明，可采用Cookie的方式傳遞stri ng32OConten tID內(nèi)容ID

27、stri ng32MServicelDIPTV服務(wù)編號stri ng32OProductIDIPTV產(chǎn)品編號stri ng32MSPIDSP的唯一標(biāo)識stri ng8OTran sact ionlD訂購的事務(wù)編號stri ng40OExpiredTime訂購關(guān)系的失效時(shí)間，格式為YYYYMMDDhhmmss。缺少該參數(shù)表示永久有效。Stri ng14OBala nee預(yù)付費(fèi)用戶的費(fèi)用余額， 單位為分。如為后付費(fèi)用 戶，該參數(shù)缺失或?yàn)榭?。Int4OFee產(chǎn)品價(jià)格，以分為單位Int4MPurchaseType0 :包月支付，用戶選擇訂購產(chǎn)品后，按 照固定包月費(fèi)用計(jì)費(fèi)，在當(dāng)月內(nèi)無需再次 向業(yè)務(wù)管理平

28、臺發(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)品Int4O4: SVOD5: PVOD5.7直播頻道列表更新接口 接口時(shí)序圖5-6-1-1 :直播頻道列表更新流程圖a) STB通過業(yè)務(wù)訂購接口完成對于直播頻道的訂購，并通過直播 訂購接口步驟7返回訂購成功的響應(yīng)。b) EPG服務(wù)系統(tǒng)將用戶重定向至業(yè)務(wù)管理平臺，要求重新設(shè)置直播頻道列表。c) 業(yè)務(wù)管理平臺通過CTCSetConfi設(shè)置訂購成功的頻道列表，并 將機(jī)頂盒重定向至EPG服務(wù)系統(tǒng)。接口協(xié)議內(nèi)容承載協(xié)議HTTP

29、 GET接口方向EPG服務(wù)系統(tǒng)重定向 -業(yè)務(wù)管理平臺接口功能直播頻道訂購成功后，對直播頻道列表進(jìn)行更新請求消息包含以下關(guān)鍵參數(shù)表5-6-2-1 :更新直播頻道列表請求參數(shù)說明名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選SPIDSP的唯一標(biāo)識Stri ng8OUserIDIPTV用戶業(yè)務(wù)編號stri ng36MReturnURL更新UserToken后返回的 URL,米用URLEncoding 的 ANSI方式stri ng256MActio n操作類型，此處使用：“ Chann elListUpdate ”Stri ng20MCha nn elIDList需要更新的頻道列表，米用” |分隔的頻道

30、 ID 列表，如 134|123|335Stri ng256M業(yè)務(wù)管理系統(tǒng)重定向返回，通過 URL參數(shù)攜帶以下信息表5-6-2-2 :更新直播頻道列表返回參數(shù)說明名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選SPIDSP的唯一標(biāo)識Stri ng8OUserIDIPTV用戶業(yè)務(wù)編號stri ng36MResult更新結(jié)果0 :成功其他：失敗Stri ng4M5.8產(chǎn)品包信息獲取接口5.8.1 接口時(shí)序EPG服務(wù)系統(tǒng)業(yè)務(wù)管理平臺圖 5-7-1-a）產(chǎn)品包獲取請求b）產(chǎn)品包獲取響應(yīng)1:產(chǎn)品包信息獲取流程圖接口協(xié)議內(nèi)容承載協(xié)議SOAP接口方向EPG服務(wù)系統(tǒng) -業(yè)務(wù)管理平臺接口功能EPG服務(wù)系統(tǒng)從業(yè)務(wù)管理平

31、臺獲取產(chǎn)品包信息。SOAP接口請求消息ProInfo不包含任何信息。SOAF接口響應(yīng)消息ProInfoResponse需要包含以下信息:表 5-7-2-1 :響應(yīng) ProInfoResponse名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選ProductA mount產(chǎn)品數(shù)量Int4MProduct產(chǎn)品列表Product見表5-6-2-2Product說明M表 5-7-2-2 : Products 說明名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選ProductIDIPTV產(chǎn)品編號Stri ng32MServiceAm ount服務(wù)數(shù)量Int4MService服務(wù)列表Service見表5-7-2-3S

32、ervice說明M表 5-7-2-3 :Serviced說明名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選ServicelDIPTV服務(wù)編號stri ng32M5.9增值業(yè)務(wù)認(rèn)證鑒權(quán)圖5-9-1:即時(shí)業(yè)務(wù)訂購流程圖a）用戶首次訪問增值業(yè)務(wù)系統(tǒng)；b）增值業(yè)務(wù)系統(tǒng)通過SSO過程獲取用戶身份，參見；c）增值業(yè)務(wù)系統(tǒng)查詢增值業(yè)務(wù)訂購信息，參見；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ù)。用戶身份重定向（SSO591.1接口時(shí)序圖5-9-1-1-1 :重定向認(rèn)證用戶身份流程使用該SSO在用戶首次訪問增值業(yè)務(wù)系

33、統(tǒng)無法判斷用戶身份時(shí), 重定向過程獲取UserToken以判定用戶身份：a）用戶訪問增值業(yè)務(wù)系統(tǒng)/IPTV業(yè)務(wù)系統(tǒng)；b）增值業(yè)務(wù)系統(tǒng)檢測UserTokenc）如增值業(yè)務(wù)系統(tǒng)檢測到合法 UserToken則返回正常使用響應(yīng)；d）增值業(yè)務(wù)系統(tǒng)無法獲取UserToken則開始重定向過程；e）增值業(yè)務(wù)系統(tǒng)將用戶重定向到業(yè)務(wù)管理平臺，攜帶ReturnURL等參數(shù)；f）業(yè)務(wù)管理平臺檢查用戶cookie獲取UserToken如果沒有檢測至通過重新認(rèn)證產(chǎn)生 UserToken（參見5.3）,并通過重定向 參數(shù)方式，將UserToken等參數(shù)返回給增值業(yè)務(wù)系統(tǒng)。接口協(xié)議內(nèi)容承載協(xié)議：SSO接口方向：:增值業(yè)務(wù)系

34、統(tǒng)T業(yè)務(wù)管理平臺接口功能：在用戶首次訪問增值業(yè)務(wù)系統(tǒng)無法判斷用戶身 份時(shí)，使用該SSO重定向過程獲取UserToken以 判定用戶身份。請求消息包含以下參數(shù)表5-9-1-2-1 :業(yè)務(wù)身份重定向請求參數(shù)名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選SPIDSP的唯一標(biāo)識stri ng8MReturnURL返回增值業(yè)務(wù)系統(tǒng)頁面的 URLstri ng256MReturnI nfo返回增值業(yè)務(wù)系統(tǒng)頁面需要攜帶的額外信 息，可用于區(qū)分不冋的 SSO請求Stri ng256OActio n操作類型，此處使用：UserToke nRequestStri ng20M用戶身份獲取后，業(yè)務(wù)管理系統(tǒng)重定向返回，通過

35、URL參數(shù)攜帶以下信息:表5-9-1-2-2關(guān)鍵信息名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選SPIDSP的唯一標(biāo)識stri ng8OUserIDIPTV用戶業(yè)務(wù)編號stri ng36OEPGGroupNMB用戶對應(yīng)的EPG分組信息標(biāo)識stri ng8OUserGroupNMB用戶對應(yīng)的分組信息標(biāo)識stri ng8OResult身份獲取結(jié)果0:成功其他：失敗Stri ng4MDescriptio n結(jié)果描述Stri ng256OUserTokenIPTV用戶業(yè)務(wù)編號stri ng36MExpiredTimeUserToken的失效時(shí)間， 格式為 YYYYMMDDhhmmss缺少在一次開機(jī)過 程

36、中該參數(shù)表示永久有效。Stri ng14OReturnI nfo返回增值業(yè)務(wù)系統(tǒng)頁面需要攜帶的額外 信息，可用于區(qū)分不冋的 SSO請求Stri ng256O5.9.2 增值業(yè)務(wù)訂購查詢接口承載協(xié)議：SOAP接口方向：:增值業(yè)務(wù)系統(tǒng)-業(yè)務(wù)管理平臺接口功能：增值業(yè)務(wù)平臺向業(yè)務(wù)管理平臺請求杳詢用戶訂 購過的所有產(chǎn)品信息。表5-9-2-1增值業(yè)務(wù)產(chǎn)品訂購查詢請求參數(shù)名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選UserToken業(yè)務(wù)管理平臺為該用戶分配的臨時(shí)身份 證明Stri ng32MUserID用戶登錄業(yè)務(wù)帳號Stri ng36OSPID增值業(yè)務(wù)SP的編號，如為空，則查詢所有SP的產(chǎn)品訂購信息Stri

37、 ng8O表5-9-2-2增值業(yè)務(wù)產(chǎn)品訂購查詢請求響應(yīng)名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選UserID用戶登錄業(yè)務(wù)帳號Stri ng36MEPGGroupNMB用戶對應(yīng)的EPG分組信息標(biāo)識Stri ng8MSTBID機(jī)頂盒ID,詳見第6章Stri ng32OMAC機(jī)頂盒的MAC地址，格式為：xx:xx:xx:xx:xx:xxStri ng17OProducts用戶已購買的增值業(yè)務(wù)IPT V產(chǎn)品編號，多個(gè)用”分隔Stri ng255OSPID增值業(yè)務(wù)SP的編號，如為空，則查詢所有SP的產(chǎn)品訂購信息Stri ng8O增值業(yè)務(wù)產(chǎn)品詳細(xì)查詢承載協(xié)議：SOAP接口方向：:增值業(yè)務(wù)系統(tǒng)-業(yè)務(wù)管理平臺

38、接口功能：增值業(yè)務(wù)系統(tǒng)向業(yè)務(wù)管理平臺請求杳詢用戶訂 購過的產(chǎn)品詳細(xì)信息。表5-9-3-1查詢產(chǎn)品詳細(xì)信息請求ProdDetailQueryReq名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選ProductID產(chǎn)品IDStri ng32MSPID增值業(yè)務(wù)SP的編號Stri ng8O表5-8-3-2查詢產(chǎn)品詳細(xì)信息請求響應(yīng)名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選ProductID產(chǎn)品IDStri ng32MProductName產(chǎn)品名Stri ng100MProductDesc產(chǎn)品描述Stri ng200OPurchaseType0 :包月支付，用戶選擇訂購產(chǎn)品后， 按照固定包月費(fèi)用計(jì)費(fèi)，在當(dāng)月內(nèi)無

39、 需再次向業(yè)務(wù)管理平臺發(fā)起訂購請 求；1：按次支付，用戶選擇訂購產(chǎn)品后， 按照使用次數(shù)進(jìn)行計(jì)費(fèi)無需重新發(fā)起 訂購請求2 :免費(fèi)int4OFee支付金額（以分為單位）int4OEPGGroupNMB產(chǎn)品使用的EPG分組Stri ng8O業(yè)務(wù)訂購5.941接口流程圖5-9-4-1-1:即時(shí)業(yè)務(wù)訂購流程圖5.942接口協(xié)議內(nèi)容承載協(xié)議HTTP GET接口方向增值業(yè)務(wù)系統(tǒng)重定向- 業(yè)務(wù)管理平臺接口功能用戶訂購業(yè)務(wù)請求消息包含以下關(guān)鍵參數(shù)表5-9-4-2-1 :業(yè)務(wù)訂購請求參數(shù)名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選SPIDSP的唯一標(biāo)識Stri ng8MUserIDIPTV用戶業(yè)務(wù)編號Stri ng

40、36OConten tIDIPTV內(nèi)容 IDstri ng32OServicelDIPTV服務(wù)編號Stri ng32MProductIDIPTV產(chǎn)品編號Stri ng32MUserToken業(yè)務(wù)管理平臺為該用戶分配的臨時(shí)身份證明，可采用Cookie的方式傳遞Stri ng32MReturnURL返回EPG服務(wù)頁面的URLStri ng256MActio n操作類型：1:表示訂購；2 :表示退訂。Stri ng20M訂購成功或取消訂購結(jié)束后，業(yè)務(wù)管理系統(tǒng)重定向返回增值服務(wù)系統(tǒng)，通過URL參數(shù)攜帶以下信息：表5-9-4-2-2 :關(guān)鍵信息名稱說明數(shù)據(jù) 類型長度 （字節(jié)）是否 必選Result業(yè)務(wù)訂

41、購結(jié)果 0：成功 其他：失敗Stri ng4MDescripti on結(jié)果描述Stri ng256OUserIDIPTV用戶業(yè)務(wù)編號stri ng36OUserToke n業(yè)務(wù)管理平臺為該用戶分配的臨時(shí)身份證明，可采用Cookie的方式傳遞stri ng32OConten tID內(nèi)容IDstri ng32OServiceIDIPTV服務(wù)編號stri ng32MProductIDIPTV產(chǎn)品編號stri ng32MProductNameIPTV產(chǎn)品名稱Stri ng100OPurchaseType0 :包月支付，用戶選擇訂購產(chǎn)品后，按 照固定包月費(fèi)用計(jì)費(fèi)，在當(dāng)月內(nèi)無需再 次向業(yè)務(wù)管理平臺發(fā)起訂購

42、請求；1：按次支付，用戶選擇訂購產(chǎn)品后，按 照使用次數(shù)進(jìn)行計(jì)費(fèi)無需重新發(fā)起訂購 請求2 :免費(fèi)Int4OFee產(chǎn)品價(jià)格，以分為單位Int4MSPIDSP的唯一標(biāo)識stri ng8OTran sact ionlD訂購的事務(wù)編號stri ng40OExpiredTime訂購關(guān)系的失效時(shí)間，格式為YYYYMMDDhhmmss。缺少該參數(shù)表示永久有效。Stri ng14O5.10 業(yè)務(wù)能力系統(tǒng)數(shù)據(jù)采集接口采集要求表5-10-1-1數(shù)據(jù)采集要求采集周期：每天采集數(shù)據(jù)形式：以文本文件存放文件命名：以 數(shù)據(jù)表名稱_yyyymmdd.txt的形式命名日期格式：以“ yyyy-mm-dd hh24:mi:ss”的格式輸出字段分割：以字符“ 1”或“，”為分割符，分割一行記錄中的多個(gè)字段文件壓縮：以ZIP對每天采集的文件壓縮打包