【文章內(nèi)容簡(jiǎn)介】 化、制作和管理模塊 與省級(jí)業(yè)務(wù)運(yùn)營(yíng)平臺(tái)之間的接口，主要完成 直播內(nèi)容 和 點(diǎn)播內(nèi)容的 傳送 、 直播內(nèi)容和點(diǎn)播內(nèi)容相關(guān) EPG 元數(shù)據(jù)信息的 管理 等功能。 省級(jí) COP 省級(jí) SOP 1） 內(nèi)容管理請(qǐng)求（ ContentMngReq） 內(nèi)容管理響應(yīng)（ ContentMngReqResponse） 3） 內(nèi)容管理結(jié)果（ ContentMngResult） 內(nèi)容管理結(jié)果響應(yīng)（ ContentMngResultResponse） 3） 執(zhí)行管理操作 2） 獲取 XML 文件 省級(jí)內(nèi)容運(yùn)營(yíng)平臺(tái) 省級(jí) 內(nèi)容運(yùn)營(yíng)平 臺(tái)（ COP） 省 級(jí)業(yè) 務(wù) 運(yùn) 營(yíng)平臺(tái)（ SOP） 省級(jí)業(yè)務(wù)運(yùn)營(yíng)平臺(tái) C2 IPTV 內(nèi)容運(yùn)營(yíng)平臺(tái)與業(yè)務(wù)運(yùn)營(yíng)平臺(tái)接口技術(shù)規(guī)范 14 本 接口采用 SOAP 協(xié)議 +XML 指令文檔的方式。 其中 ， SOAP 消息是與具體指令內(nèi)容無(wú)關(guān)的通用消息，僅僅用于表達(dá)命令請(qǐng)求 。 而具體的命令及參數(shù)利用獨(dú)立的 XML文件 來(lái)描述。采用與具體指令無(wú)關(guān)的通用 SOAP 消息有利于指令擴(kuò)展及在異步環(huán)境中實(shí)現(xiàn)通用的可靠消息傳遞機(jī)制。 1） 內(nèi)容管理請(qǐng)求（ ContentMngReq） 承載協(xié)議： SOAP 接口方向： 省級(jí) COP － 省級(jí) SOP 調(diào)用接口 ： ContentMngReq response ContentMngReq 接口功能 ： 點(diǎn)播內(nèi)容、直播內(nèi)容、 EPG 元數(shù)據(jù)的下發(fā)及管理。 其中 ContentMngRequest 包含如下信息 ： 名稱 說(shuō)明 數(shù)據(jù)類型 長(zhǎng)度（字節(jié)） 是否必選 COPID 省級(jí)內(nèi)容運(yùn)營(yíng)平臺(tái)標(biāo)識(shí) String 8 M SOPID 省級(jí)業(yè)務(wù)運(yùn)營(yíng)平臺(tái)標(biāo)識(shí) String 8 M CorrelateID 關(guān)聯(lián)性標(biāo)識(shí) ，用于關(guān)聯(lián)指令執(zhí)行請(qǐng)求消息和結(jié)果通知消息。對(duì)于重發(fā)的指令，該字段值保持一致，對(duì)于不同的指令，該字段在一個(gè)內(nèi)容運(yùn)營(yíng)平臺(tái)內(nèi)具有唯一性。 String 20 M ContentMngXMLURL 存放 內(nèi)容管理 的 XML文件URL String 1024 M 內(nèi)容管理響應(yīng)（ ContentMngReqResponse） 其中 ContentMngReqResponse 包含： 名稱 說(shuō)明 數(shù)據(jù)類型 長(zhǎng)度（字節(jié)） 是否必選 ResultCode 處理結(jié)果 詳見(jiàn)附件 A“處理結(jié)果（ ResultCode）錯(cuò)誤代碼表” Int 4 M IPTV 內(nèi)容運(yùn)營(yíng)平臺(tái)與業(yè)務(wù)運(yùn)營(yíng)平臺(tái)接口技術(shù)規(guī)范 15 ErrorDescription 對(duì)錯(cuò)誤 /異常的詳細(xì)描述信息 String 256 O 2）管理 文件獲取 接口方向：省級(jí) COP － 省級(jí) SOP 調(diào)用接口：無(wú) 接口功能： SOP 通過(guò) FTP 方式 獲 取 存放管理信息的 XML 文件 3） 內(nèi)容管理結(jié)果（ ContentMngResult） 承載協(xié)議： SOAP 接口方向： 省級(jí) COP － 省級(jí) SOP 調(diào)用接口： ContentMngResult response ContentMngResult 接口功能： SOP 完成管理操作后，通知 COP 操作結(jié)果。 說(shuō)明：本接口支持通過(guò)指令方式和文件方式兩種方式返回操作結(jié)果。指令方式指通過(guò)指令中的字段信息表示操作結(jié)果，文件 方式指通過(guò) XML 文件返回操作結(jié)果。 其中 ContentMngResult 包含： 名稱 說(shuō)明 數(shù)據(jù)類型 長(zhǎng)度（字節(jié)） 是否必選 COPID 內(nèi)容運(yùn)營(yíng)平臺(tái)標(biāo)識(shí) String 8 M SOPID 業(yè)務(wù)運(yùn)營(yíng)平臺(tái)標(biāo)識(shí) String 8 M CorrelateID 關(guān)聯(lián)性標(biāo)識(shí)，用于關(guān)聯(lián)指令執(zhí)行請(qǐng)求消息和結(jié)果通知消息 String 20 M ResultCode 處理結(jié)果： 0：成功 1：失敗 Int 4 O ErrorDescription 對(duì)錯(cuò)誤 /異常的詳細(xì)描述信息 String 256 O ResultFileURL 應(yīng)答 XML文件的 URL String 1024 O IPTV 內(nèi)容運(yùn)營(yíng)平臺(tái)與業(yè)務(wù)運(yùn)營(yíng)平臺(tái)接口技術(shù)規(guī)范 16 備注說(shuō)明： 本接口中， CorrelateID值應(yīng)該與 ContentMngReq消息中包含的 CorrelateID相等，以標(biāo)識(shí)是對(duì)該消息的執(zhí)行結(jié)果反饋 。 本接口中 ， ResultCode和 ResultFileURL兩者有且只有一項(xiàng)出現(xiàn)。 內(nèi)容管理結(jié)果響應(yīng)（ ContentMngResultResponse） 其中 ContentMngResultResponse 包含： 名稱 說(shuō)明 數(shù)據(jù)類型 長(zhǎng)度（字節(jié)） 是否必選 ResultCode 處理結(jié)果 詳見(jiàn)附件 A“處理結(jié)果（ ResultCode）錯(cuò)誤代碼表” int 4 M ErrorDescription 對(duì)錯(cuò)誤 /異常的詳細(xì)描述信息 String 256 O IPTV 內(nèi)容運(yùn)營(yíng)平臺(tái)與業(yè)務(wù)運(yùn)營(yíng)平臺(tái)接口技術(shù)規(guī)范 17 C3 接口 （ 運(yùn)營(yíng) 數(shù)據(jù) 接口） C3 接口指省級(jí) COP 內(nèi)容運(yùn)營(yíng)管理模塊 和省級(jí) SOP 業(yè)務(wù)管理平臺(tái)之間的接口，主要完成用戶數(shù)據(jù)同步、 定購(gòu) 數(shù)據(jù)同步、 收拾 數(shù)據(jù)同步等功能。 要求 文件采用 ASCII 文本格式，文件體中每條記錄的屬性值按順序排列，各屬性間使用分隔符（默認(rèn)為‘，’，建議可 配置）分隔，在生成文件時(shí)若相應(yīng)的屬性值為空， 則用大寫(xiě)字符串“ NULL”表示 。 文件中一行作為一條記錄，各條記錄之間用“回車，換行符”作為分隔并在文件中連續(xù)書(shū)寫(xiě)。 當(dāng) 文件中的 某字段不足規(guī)定長(zhǎng)度時(shí)，采用左對(duì)齊的 方式， 不需要補(bǔ)足規(guī)定長(zhǎng)度。 文件 生成 周期及 生成 時(shí)間 應(yīng)可以 根據(jù)文件類型分別 設(shè)置 ， 缺省設(shè)置 文件 生成周期為一天一次， 文件 生成 時(shí)間 為 每天凌晨 1 點(diǎn) 。 要求 文件命名規(guī)則： .日期 .序列號(hào) .txt C3 省級(jí) 內(nèi)容 運(yùn)營(yíng)平臺(tái) （ COP） 省級(jí)業(yè)務(wù) 運(yùn)營(yíng)平臺(tái) （ SOP） 業(yè)務(wù)管理平臺(tái) 用戶數(shù)據(jù) 、定購(gòu)數(shù)據(jù)、收視數(shù)據(jù)等 內(nèi)容運(yùn)營(yíng) 管理模塊 IPTV 內(nèi)容運(yùn)營(yíng)平臺(tái)與業(yè)務(wù)運(yùn)營(yíng)平臺(tái)接口技術(shù)規(guī)范 18 文件類型定義： Userinfo：表示用戶信息 的數(shù)據(jù) 同步 Orderinfo：表示 用戶 定購(gòu) 信息 的數(shù)據(jù) 同步 Viewinfo：表示用戶收視信息的數(shù)據(jù)同步 日期表示生成該文件的時(shí)間，其格式為：年年年年月月日日時(shí)時(shí)分分秒秒，如 20200703202000 表示文件生成時(shí)間為 2020 年 7 月 3 日 20 時(shí) 12 分 00 秒。 序列號(hào)： 0000~9999，由 0000 開(kāi)始順序增 1 不同的文件類型，其 文 件內(nèi)容格式也不同，分別定義如下。 數(shù)據(jù) 名稱 說(shuō)明 數(shù)據(jù)類型 長(zhǎng)度（字節(jié)） 是否必選 UserId 用戶標(biāo)志 String 36 M usergroup 用戶組： 00：測(cè)試用戶 01：普通用戶 02：集團(tuán)用 戶 String 64 M EPGgroup EPG分組編號(hào) String 32 M UserName 用戶姓名 String 64 M STBID 機(jī)頂盒 ID String 32 O IDNumber 身份證號(hào) /護(hù)照號(hào) /社保號(hào) String 18 O Phone 聯(lián)系電話 String 32 O Sex 用戶性別 String 1 O Address 用戶地址 String 256 O PostalCode 郵編 String 16 O Email 電子郵件 String 64 O Areacode 區(qū)局 String 5 M Services 用戶訂購(gòu)的服務(wù)列表，用半角逗號(hào)分割 String 1024 M Packages 產(chǎn)品包對(duì)應(yīng)的 Package集合（ Code）用半角逗號(hào) 分割 String 2048 O timestamp 時(shí)間戳，從 1970年 1月 1日 0時(shí)開(kāi)始的毫秒數(shù) String =18 M 信息 數(shù)據(jù) 名稱 說(shuō)明 數(shù)據(jù)類型 長(zhǎng)度（字節(jié)） 是否必選 IPTV 內(nèi)容運(yùn)營(yíng)平臺(tái)與業(yè)務(wù)運(yùn)營(yíng)平臺(tái)接口技術(shù)規(guī)范 19 UserId 用戶標(biāo)志 String 36 M SubscribeTime 訂購(gòu)時(shí)間（格式 YYYYMMDD HHMMSS） String 14 M ContentCode 內(nèi)容 的唯一標(biāo)識(shí) String 256 M ContentName 內(nèi)容 名稱 String 256 M OrderType 消費(fèi)類型 ： 單次訂購(gòu) 包時(shí)段訂購(gòu) Int 2 M ServiceID 訂購(gòu)所屬的 業(yè)務(wù) 標(biāo)識(shí) String 32 M Fee 費(fèi)用（分） Int 12 M ValideTime 訂購(gòu) 生效 時(shí)間（格式 YYYYMMDD HHMMSS） String 14 M ExpiredTime 訂購(gòu) 結(jié)束時(shí)間（格式 YYYYMMDD HHMMSS） String 14 M VisitPath 用戶點(diǎn)播時(shí)候的節(jié)目?jī)?nèi)容在展示欄目上的路徑，每個(gè)欄目使用 Code來(lái)標(biāo)識(shí)，例如： /Movie/Action/China: 表示點(diǎn)播的節(jié)目為電影欄目下的，動(dòng)作片子欄目下的中國(guó)欄目下 String 128 M SequenceID 本次消費(fèi)產(chǎn)生的唯一序列號(hào)，和收視日志中的唯一序列號(hào)是相匹配 String 64 M 名稱 說(shuō)明 數(shù)據(jù)類型 長(zhǎng)度（字節(jié)） 是否必選 UserId 用戶標(biāo)志 String 36 M BeginTime 起始時(shí)間（ 格式 YYYYMMDD HHMMSS） String 14 M EndTime 結(jié)束時(shí)間（格式 YYYYMMDD HHMMSS） String 14 M ServiceType 服務(wù)類型 1： VOD（點(diǎn)播節(jié)目） 2： TV 3： PVR 4： TVOD 5：時(shí)移 6： … Int 2 M ContentCode 內(nèi)容 的唯一標(biāo)識(shí) String 256 M ContentName 內(nèi)容 名稱 String 256 M IPTV 內(nèi)容運(yùn)營(yíng)平臺(tái)與業(yè)務(wù)運(yùn)營(yíng)平臺(tái)接口技術(shù)規(guī)范 20 SequenceID 收視記錄唯一序列號(hào)，和消費(fèi)日志中的唯一序列號(hào)是相匹配 String 64 M ShiftDuration 時(shí)移的時(shí)間（單位為秒）， TVOD有效 Int 12 O Flux 總流量 (KB) Int 12 M EndReason 流媒體服務(wù)中斷原因 0:正常掛斷（ VOD節(jié)目結(jié)束） 1:用戶中斷 2:Server內(nèi)部錯(cuò)誤 3:和 Client網(wǎng)絡(luò)中斷 4:計(jì)費(fèi)時(shí)間到 5:計(jì)費(fèi)流量到 Int 2 M Product 該服務(wù)所屬產(chǎn)品標(biāo)識(shí) String 20 O ChargeType 計(jì)費(fèi)類型 0：免費(fèi) 1：包時(shí)段訂購(gòu)（本次不收費(fèi)，包月，24小時(shí)） 2：按時(shí)長(zhǎng)計(jì)費(fèi) 3：按流量計(jì)費(fèi) Int 12 O SumFee 費(fèi)用（分） Int 12 O Qos 服務(wù)過(guò)程中平均質(zhì)量，范圍 (1100)， 100最高質(zhì)量 Int 12 O 名稱 說(shuō)明 數(shù)據(jù)類型 長(zhǎng)度（字節(jié)） 是否必選 ContentCode 內(nèi)容 的唯一標(biāo)識(shí) String 256 M ContentName 內(nèi)容 名稱 String 256 M ContentState 內(nèi)容當(dāng)前所處狀態(tài) 0：內(nèi)容上線 1：內(nèi)容下線 2：內(nèi)容刪除 Int 4 M 接口協(xié)議 ： FTP 文件 采集點(diǎn) ： syncdata 目錄 文件 備份目錄 ： syncdatabackup 目錄 IPTV 內(nèi)容運(yùn)營(yíng)平臺(tái)與業(yè)務(wù)運(yùn)營(yíng)平臺(tái)接口技術(shù)規(guī)范 21 為了便于 COP 的采集， SOP 應(yīng)建立多級(jí)子目錄 ，對(duì)要傳送的文件進(jìn)行管理。 文件實(shí)際 保存 在 “ backup” 目錄中，存放在 “ syncdata” 目錄中的是指向 “ backup”目錄同名文件的符號(hào)連接。 采集方式： COP 通過(guò) FTP 連接 到采集點(diǎn)（ syncdata 目錄），拷貝后刪除，如果有問(wèn)題，應(yīng)能從 備份目錄 中獲取同名的文件；備份目錄的維護(hù)應(yīng)該由 SOP負(fù)責(zé)；至少保留七天，定期自動(dòng)刪除， COP 對(duì)備份目錄只有 “ 讀 ” 權(quán)限。 Userinfo COPID 根目錄 syncdata Syncdatabackup Orderinfo Userinfo COPID Orderinfo Viewinfo