版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
1、等级:企业 中国电信公司技术标准Q/CT2372-2011IPTV 业务系统与业务能力业务管理接口技术要求V3.0Technical specification ofbetn service management platform and service capacity platform2011-09-07 发布2011-09-07 实施I中国电信公司发布erfaQ/CT 2372 - 2011目次目次I前言III接术要求1业务管理与业务能力范围11文件12规范性缩略语、术语和定义13缩略语1术语和定义2概述34总体架构3业务流程556基本业务使用流程5扩展业务使用流程10接口说明1277.
2、1基本业务相关接口12EPG 首页鉴权接口12产品鉴权接口13UserToken 更新接口15产品订购接口16频道列表更新接口18产品包信息同步接口19收藏接口20收藏夹接口......127.1.13接口21已收藏书签同步接口22书签反向同步接口22书签列表接口23书签接口24扩展业务相关接口247.2用户重定向 SSO24产品订购情况查询接口26产品详细查询接口26产品订购接口2..4附录 A (资料性附录) 规范版本修订29IQ/CT237
3、2-2011IIQ/CT 2372 - 2011前言本标准电信 IPTV 系列技术标准之一,截止本标准发布之日,该系列规范的名称如下:(1)IPTV 业务系统业务技术体制(V3.0)(2)IPTV 业务系统接术要求(V3.0)内容提供商与内容管理(3)IPTV 业务系统内容管理技术要求(V3.0)(4)IPTV 业务系统与业务运营接术要求(V3.0)内容管理(5)IPTV 业务系统技术要求(V3.0)终端管理(6)IPTV 业务系统业务管理技术要求(V3.0)(7)IPTV 业务系统EPG 页面制作及显示技术要求(V3.0)(8)IPTV 业务系统业务能力接术要求(V3.0)(9)IPTV 业
4、务系统接术要求(V3.0)业务管理与业务能力(10) IPTV 业务系统终端与终端管理接术要求(V3.0)(11) IPTV 业务系统终端与业务运营接术要求(V3.0)(12) IPTV 业务系统标清机顶盒设备技术要求(V3.0)(13) IPTV 业务系统机顶盒设备技术要求(V3.0)本标准主要依据中国电信企业标准IPTV 业务管理与业务能力接术规范V2.0、行业标准IPTV 业务管理系统体系架构为基础,结合中国电信近年来在 IPTV 业务运营中总结的经验以及新业务发展的需求,同时重点考虑“三网融合”新形势下对于融合类业务发展的需求,在充分考虑原有规范延续性及相关业务平滑升级的前提下,对于该
5、规范进行修订。随着中国电信 IPTV 技术标准体系的发展完善,还将制定后续的相关标准。电信IPTV接术规范 V2.0基础上编本标准业务管理与业务能力制而成,与IPTV 业务管理与业务能力接术规范 V2.0的主要差异如下:-对于文档结构进行修订;-增加整体业务流程说明;-增加互动业务相关接口;-对于原有版本中的笔误等进行修订;IIIQ/CT 2372 - 2011本标准包含中国电信的专利等知识,相关厂商需经中国电信方可使用本标准。本标准由中国电信公司提出并归口。本标准起草:中国电信本标准主要起草人:、本标准于 2005 年首次发布 V1.0 版本,2006 年第一次修订后发布为 V1.5 版本,
6、2008年第二次修订后发布为 V2.0 版本,本次为第三次修订发布为 V3.0 版本。IV业务管理与业务能力接术要求1范围本标准主要规定了中国电信 IPTV 业务系统中的 IPTV 业务管理与业务能力间的流程及接口。在本标准中描述了 IPTV 业务管理与基本业务能力、扩展业务能力间进行用户认证、书签与收藏、业务鉴权订购等的详细流程,以及在相关流程中所涉及的具体接口定义。本标准适用于指导中国电信IPTV 业务管理及业务能力基本业务门户及扩展业务门户的开发。2规范性文件下列文件中的条款通过本标准的而成为本标准的条款。凡是注日期的文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,
7、然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的版本。凡是不注日期的文件,其版本适用于本标准。RFC 2616Hypertext TransfrotocolRFC 3275Extensible Makeup LanguageRFC 3288Using the Simple Object Acs ProtocolW3CWeb ServiDescription Language3缩略语、术语和定义3.1缩略语下列缩略语适用于本标准:EPGElectronic Programmer Guide电子单HTTPHyperText Transfrotocol超文本传输协议HTMLHypertex
8、t Markup Language超文本标记语言MACMedia Acs Control控制层SOAPSimple Object Acs Protocol简单对象协议1STBSet ToxIPTV 终端URiform Resource Locator资源定位XMLExtensible Makeup Language可扩展标记语言3.2术语和定义IPTV 业务(IPTV Service Platform)YD/T 1696-2007:业务包括业务管理系统、门户导航系统、交付系统、运维支撑系统、安全管理系统和扩展业务系统,机顶盒通过与这些系统的交互完成 IPTV 的内容管理和业务管理、认证、计费、
9、鉴权以及流的服务等功能。电视(Linear TV) YD/T 1823-2008:是指用户根据频道直接选择并收看电视,系统侧向选择该广播频道的全部用户同时推送相同的音流,既定的内容,为用户提供电视。点播(on Demand)YD/T 1823-2008:能向用户提供音内容的业务,用户可以对过程进行控制,控制包括快进、快退、重放等。时移电视(Time-shift TV) YD/T 1823-2008:对实时的广播频道进行短暂的暂停、倒退和快进操作的业务。EPG服务系统(EPGystem) YD/T 1920-2009:EPG服务系统分为EPG系统和应用服务系统。EPG系统为用户提供业务服务的界面
10、,通过此系统,用户可以完成节目的浏览、点播和收看并可以完成一些与用户相关的自服务项目(如查询账户余额、修改服务类型等)。应用服务系统负责区域内用户认证、机顶盒的性检查并负责为区域内用户提供上层服务器的服务接口(如查询价格、生成使用话单等)。增值业务系统(Value-added YD/T 1920-2009:增值业务系统主要为用户提供除基本的流服务外的其他增值业务,如互联网浏览、通信、即时消息、信息服务等。这些业务一部分可以由运营商自己提供,如通信;另一些业务既可以由运营商自己提供,也可以由第提供。内容管理系统(Content Management System) YD/T 1920-2009:
11、该系统负责对业务系统中的内容进行管理,按照一定的策略对内容进行增加、删除、移动、查询和编播计划安排。通过与内容制作系统、流服务系统和 EPG 服务系统的接口协调这些系统进行协同工作,对内容或增值业务内容进行相关统计和报表生成。内容管理系统中含有 DRM 的2密钥管理部分。OSS 系统(Operation Support System) YD/T 1920-2009:是指业务的运营支撑系统,通过该系统运营商可以完成对用户的管理,包括、认证与、计扣费管理以及定价策略管理等。通常,OSS 系统中可包含 DRM 的部分。IPTV业务能力本标准定义:业务能力是指为IPTV终端提供最终页面浏览、流服务等能
12、力的总称,在本标准中特指业务能力层中的基本业务能力及扩展业务能力的统称。4概述IPTV 业务管理作为 IPTV 业务系统中的功能模块主要提供与用户及业务相关在内的 IPTV 业务能力的管理功能,而包括基本业务能力与扩展业务能力则为用户提供基于 EPG 页面的业务展现。在本标准中通过定义IPTV 业务管理与业务能力间的接口实现了用户在业务使用过程中的收藏及书签、认证、业务鉴权订购等相关功能。5总体架构IPTV 业务管理与IPTV 业务能力内各间接口关系的总体框架如下图所示:3基本业务 能力 B F扩展业务 能力 IP T V 业 务管 理B V B V 服 务 B V 图 1 IPTV 业务管理
13、与业务能力关系框架图如上图所示,IPTV 业务管理与 IPTV 业务能力各间的关系描述如下:与基础业务门户的关系(BF 接口)IPTV 业务管理与基本业务门户间的接口是用户在基本业务能力问IPTV 业务过程中最重要的接口。基本业务门户通过 HTTP 重定向、SOAP 等方式实现与 IPTV 业务管理间基础业务相关的产品信息同步、首页鉴权、产品鉴权订购、用户更新、频道列表更新、书签及收藏信息同步等功能。与扩展业务门户、及信息服务的关系( BV 接口)IPTV 业务管理与扩展业务能力内的扩展业务门户、及信息服务间的交互主要用于完成用户使用 IPTV 扩展业务过程中涉及的用户获取、扩展业务产品鉴权订
14、购、订购关系查询等业务功能。46业务流程6.1基本业务使用流程在本章节中主要描述用户使用IPTV 基本业务过程中所涉及到的相关业务流程及接口调用说明。5用 户 终 端 IP T V 业 务 管理 基本业务门户 用 户 开 机 认证及 首 页 鉴 权 流 程 2 用户业务鉴权,下发业务信息 1 开机 3 重定向至基本业务门户EP G 首 页 鉴 权45基本业务 6 检 查 用 户产品订购情况 基 本 业 务 产 品 鉴 权 流 程 7 若用户已订购则允许用户直接使用8 若用户未订购则发起产品鉴权9 返回产品鉴权结果页面基 本 10 用户确认订购产品业 务 产 品 订 购 流 程 11 产 品 订
15、 购12 返回产品订购结果页面13 若用户订购的产品含频道,则 将机顶盒重定向至业务管理14 在业务管理更新频道列表15 用户使用基本业务 1 7 U serTo ken 失效则重定向至业务管 理 更 新18 U serTo ken 更新后重新返回基本业 务 能 力19 用 户EP G 进行 收藏 20 重定向至收藏界面21 确认 进 行 收 藏22 返回收藏前的EP G 2 3 收藏列表页面并选择收藏 及流 程 24 重定向至页面25 返回页面内容并书签26 27 书 签 同 步28 返回书签结果书 签 及29书签列表,并选择书签流 程 30 重定向至界面31 返回页面6U s er T o
16、 ke n更新流程 16 验证 U serTo ken 有效期 基 本 业 务 频 道 列 表 更 新 流 程 图 2 IPTV 基本业务使用流程【流程说明】用户开机认证及首页鉴权流程1、 用户打开 IPTV 终端;2、 IPTV 终端IPTV 业务管理进行开机的业务认证,并在通过认证后由业务管理下发相关业务信息。具体流程请参考V2.0 终端与业务运营接术要求相关章节;3、 IPTV 业务管理完成终端业务认证后,将 IPTV 终端重定向至基本业务门户;4、 基本业务门户接收到 IPTV 终端的接入请求后,通过与 IPTV 业务管理进行 EPG 首页鉴权。具体流程请参考本标准“EPG 首页鉴权接
17、口”相关说明;基本业务产品鉴权流程5、 用户终端完成业务接入认证后,用户在 IPTV 基本业务门户问属于某产品的节目内容;6、 IPTV 基本业务门户根据业务中的用户在门户本地缓存中查询该用户是否已订购该产品;7、 若该用户已订购该产品,则允许用户直接该;8、 若用户未订购该产品,则 IPTV 基本业务门户通过与 IPTV 业务管理发起产品鉴权请求查看 IPTV 业务管理上用户的产品订购。具体流程请参考本标准“基本业务产品鉴权接口”相关说明;9、在 IPTV 基本业务门户接到来自于 IPTV 业务管理的鉴权响应后,将产品鉴权结果返回给 IPTV 终端;基本业务产品订购流程10、若用户未订购该产
18、品,则用户可以在返回的产品鉴权结果页面中确认该产品;11、IPTV 基本业务门户通过与 IPTV 业务管理进行交互完成该用户对于该产品的订购。具体流程请参考本标准“基本业务产品订购接口”相关说明;7【注】:在用户使用 IPTV 基本业务前,IPTV 业务管理需将 IPTV 基本业务的服务及产品间的打包关系传递给 IPTV 基本业务门户。具体流程请参考本标准“产品包信息同步接口”相关说明;12、在 IPTV 基本业务门户接收到来自于 IPTV 业务管理的产品订购响应后,将该结果返回给 IPTV 终端向用户进行展示;频道列表更新流程13、频道的产品,则 IPTV 基本业务门户应将用如果用户订购的产
19、品中包含有户重定向至 IPTV 业务管理进行频道列表的更新;14、IPTV 业务管理向 IPTV 终端重新下发频道列表,并将终端重定向至 IPTV基本业务门户。具体流程请参考本标准“频道列表更新接口”相关说明;UserToken 更新流程15、在用户使用基本业务的过程中,IPTV 基本业务门户需要使用 IPTV 业务管理为用户分配的临时令牌 UserToken 进行验证。但由于该 UserToken具备有一定的有效期,因此可能存在令牌过期的情况;16、IPTV 基本业务门户可以在 Ses或中获取用户 UserToken 并验证其有效期;17、如果用户 UserToken 在 Ses或中过期,则
20、 IPTV 基本业务门户将用户重定向至 IPTV 业务管理进行 UserToken 的更新。具体流程请参考“UserToken 更新接口”相关说明;18、IPTV 业务管理根据用户原有 UserToken 生成新的 UserToken 后,将用户重定向至 IPTV 基本业务门户。具体流程请参考“UserToken 更新接口”相关说明;收藏及流程19、考虑到 IPTV 业务管理能够对接多个 IPTV 基本业务能力,且用户可能在多个能力间进行平移,为保证用户平移过程目收藏信息不会发生丢失,且满足将来互动业务的需要。因此将用户的收藏信息在 IPTV 业务管理平台进行保存。用户通过 IPTV 基本业务
21、门户对于的内容进行收藏;20、IPTV 基本业务门户将用户重定向至 IPTV 业务管理进行的收藏。具目收藏接口”相关说明;体流程请参考本标准21、IPTV 业务管理在收到用户的收藏请求后,对于该用户的收藏请求进行确认并保存;22、IPTV 业务管理在完成收藏后,将用户重定向回 IPTV 基本业务门户继续使用业务。具体流程请参考本标准目收藏接口”相关说明;23、用户也可以通过IPTV 业务管理的收藏列表界面对于已经收藏的8进行查看并;24、当用户在IPTV 业务管理上的收藏列表界面中选择某个已经收藏的节目进行时,IPTV 业务管理将 IPTV 终端重定向至 IPTV 基本业务门户。具体流程请参考
22、本标准目收藏接口”相关说明;页面进行25、IPTV 基本业务门户将生成的页面返回给 IPTV 终端进行并进行的;书签及流程26、考虑到 IPTV 业务管理能够对接多个 IPTV 基本业务能力,且用户可能在多个能力间进行平移,为保证用户平移过程目书签信息不会发生丢失,且满足将来互动业务的需要。因此将用户的书签信息在 IPTV 业务管理平台进行保存。用户通过 IPTV 基本业务门户对于的内容进行书签的记录;27、IPTV 基本业务门户在完成书签与 IPTV 业务管理后,通过进行书签信息的同步。同时,当用户从一个 IPTV 基本业务能力转移至另一个基本业务能力或在互动业务中外部能力系统的互动业务支撑
23、系统向 IPTV进行书签同步时,也需要 IPTV 业务管理将用户的书签信息反向同步给 IPTV 基本业务能力。具体流程请参考本标准中“书签同步及反向同步接口”相关说明;28、IPTV 基本业务门户在接收到 IPTV 业务管理返回的书签同步结果后,向用户展现书签结果;29、用户可以直接在 IPTV 基本业务门户问已经的书签,也可以在 IPTV业务管理上查看所有已经的书签列表;30、当用户在书签列表中选择某个的书签进行时,IPTV 业务管理将用户重定向至 IPTV 基本业务门户。具体流程请参考本标准接口”目书签相关说明;31、IPTV 基本业务门户根据用户的及书签,向用户返回界面并控制终端从书签处
24、开始;9而导致基本业务门户设置的Ses或过期的情况而门户无法再获取到用户。6.2扩展业务使用流程在本章节中主要描述了用户使用 IPTV 扩展业务时所涉及到的所有业务流程及接口说明。用户 终端 扩展业务门户及其他扩展业务IP T V 业务 管理 1、用户扩展业务3、如果在 S es中 已 2、检查用户有 用 户,则直接 返回业务内容用户 4、如果无用户,则定向 至IP T V 业重定向 S S O流程 务管理进行获取5、IP T V 业务管理在重定向响应中将用户通知IP T V扩展业务门户6、返回扩展业务内容7、用户扩展业务扩展业务 产品详情 查询及订 购情况 查询流程 8、扩展业务产品详情查询
25、 9、扩展业务订购情况查询 1 0 、返回扩展业务内容 1 1 、用户选择订购扩展业务1 2 、确认用户是否已订购该业务1 3 、若用户未订购该业务则重定向至1 4 、确认用户 订 购 并I P T V业务管理进行订购1 5 、用户完成订购后重定向回扩展业务门户 扩展业务 产品订购 流程 1 6 、向用户返回业务订购情况 图 3 扩展业务使用流程【流程说明】用户重定向 SSO 流程1、 当用户已经完成业务开机认证后,可以通过基本业务门户扩展业务门户(由于业务流程无差别,因此以下描述中将以“扩展业务门户”为例进行说明);102、 当用户并写入 Ses扩展业务门户时,门户需要获取到该用户的或中,因
26、此扩展业务门户将会对于用户的进行检查;3、 如果该用户的已经在 Ses或中保存,则扩展业务门户或扩展业务直接从中获取到用户的进行验证,并向通过验证的用户请求内容返回给IPTV 终端进行展现;4、 如果该用户未进行保存,则扩展业务门户将用户重定向至 IPTV 业务管理以获取用户。具体流程请参考本标准“用户重定向 SSO 接口” 相关说明;5、 IPTV 业务管理根据用户在 HTTP 重定向中带有的 UserToken ,返回该USerToken 对应的用户(UserID),并将用户重定向回 IPTV 扩展业务门户。具体流程请参考本标准“用户重定向 SSO 接口”相关说明;【注】:用户在使用 IP
27、TV 扩展业务时,扩展业务门户会通过 Ses或的方式对用户的进行临时。但是,由于 Ses或存在有效期,因此会造成当用户长时间不进行操作或在某业务中停留时间过长,从而导致扩展业务门户设置的 Ses或 过期的情况而门户无法再获取到用户。此时,IPTV 扩展业务可启动用户重定向 SSO 流程。6、 IPTV 扩展业务门户根据IPTV 业务管理返回的用户向用户展现相应的扩展业务页面;扩展业务产品详情查询及订购情况查询流程7、 当用户扩展业务门户时,也可以在该门户上查看各扩展业务产品的详情及用户扩展业务产品订购情况;8、 IPTV 扩展业务门户可以在闲时,也可以在用户时通过与 IPTV 业务管理平台进行
28、交互,获取扩展业务产品的详情。具体流程请参考本标准“扩展业务产品详情查询接口”相关说明;9、 IPTV 扩展业务门户可以在闲时,也可以在用户时通过与 IPTV 业务管理平台进行交互,获取用户扩展业务产品的订购情况。 具体流程请参考本标准“扩展业务产品订购情况查询接口”相关说明;10、IPTV 扩展业务能力根据用户的请求,返回扩展业务详情或用户扩展业务订购情况;扩展业务产品订购流程11、用户可以在扩展业务门户上选择订购某个扩展业务;1112、当用户在扩展业务门户上确定某扩展业务时,扩展业务门户需向用户进行确认;13、当用户确认某扩展业务后,IPTV 扩展业务门户将用户重定向至 IPTV 业务管理
29、进行业务订购。具体流程请参考本标准“扩展业务产品订购接口”相关说明;14、IPTV 业务管理确认用户的订购请求,并进行;15、IPTV 业务管理在用户完成扩展业务订购后,将用户重定向回 IPTV 扩展业务门户。具体流程请参考本标准“扩展业务产品详情查询接口”相关说明;16、IPTV 扩展业务门户向用户展现扩展业务订购情况,并允许用户使用该扩展业务。7接口说明7.1基本业务相关接口7.1.1EPG 首页鉴权接口请求消息 EPGAuth 包含如下信息:表 1 首页鉴权请求【EPGAuth】应答消息 EPGAuthResponse 包含以下信息:表 2 首页鉴权响应【EPGAuthResponse】
30、12名称说明数据类型长度(字节)是否必选名称说明数据类型长度(字节)是否必选UserToken业务管理为该用户分配的临时明String32M承载协议:HTTP SOAP接口方向:基本业务门户 -业务管理接口功能:基本业务门户向业务管理请求鉴权,通过鉴权后再向用户下发 EPG 首页7.1.2产品鉴权接口SOAP 接口请求消息 ServiceAuthReq 包含如下信息:13承载协议:HTTP SOAP接口方向:基本业务门户 -业务管理接口功能:基本业务门户向业务管理请求某个基本业务产品的鉴权UserIDIPTV 用户业务String36MResult处理结果,0:成功 其他:失败String4M
31、EPGGroupNM B用户对应的 EPG 分组信息标识,格式: A1A2B1B2B3C1C2C3A1A2:省份标识,如:sh:hi:海南B1B2B3:用户类型标识C1C2C3:保留;String8MDescription结果描述String256OUserGroupNMB用户对应的用户分组信息标识String8OSTBID终端string32OMAC终端的 MAC 地址,格式为::String13OProducts用户已 的 IPTV 产品 组合,组合间采用”;”分隔,组合内采用”,”分隔,分别为产品 ID,内容 ID,可以为以下情形:1、 ProductID:表示整个产品的订购关系,且有效
32、期未知;2、ProductID,ExpiredTime :表示整个产品的订购关系,且存在有效期;String不定OTokenExpiredTi meUserToken 的失效时间,格式为YYYYMMDDhhmimiss。缺少该参数表示有效。String14O表 3基本业务产品鉴权请求【ServiceAuthReq】应答消息 ServiceAuthResponse 包含如下信息:表 4基本业务产品鉴权响应【ServiceAuthResponse】14名称说明数据类型长度(字节)是否必选Result处理结果 0:成功 其他:失败String4MServiceIDIPTV 服务string32MTr
33、anionID事务string40MProductIDIPTV 产品string32OContentIDIPTV 内容string32OExpiredTim e本订购关系的鉴权失效时间,用绝对时间表示。格式为:YYYYMMDDhhmmss。如本参数为空,则表示该订购关系的鉴权长期有效;如本参数为当前时间,则表示该订购关系的鉴权 有效。String14OBalance预用户余额,为分。如为后用户,该参数缺失或为空4OProductList可订购的产品列表,在订购失败并返回“用户未Product不定O名称说明数据类型长度(字节)是否必选UserIDIPTV 用户业务string36MUserTok
34、en业务管理为该用户分配的临时明string32MServiceIDIPTV 服务string32MTimeSt从 1970 年 1 月 1 日 0 时开始的毫秒数digit string业务管理接口功能:在 UserToken 过期时,基本业务能力重定向到业务管理请求新的UserToken名称说 明数据类型长度(字节)是否必选ProductID产品IDString32MProductName产品名称String100MFee产品价格,以分为4MPurchaseTyp e0:包月支付,用户选择订购产品后,按照固定包月费用计费,在当月内无需再次向业务管理发起订购请求; 1:按次支付,用户选择订购
35、产品后,按照使用次数进行计费无需重新发起订购请求2:按次或包月,保留,暂时不用3:ppv,用户选择订购产品后,进行计费。再次使用时仍需订购该产品4:SVOD5:PVOD4OProductDesc产品描述String200OListPrice标称价格,以分为4ORentalTerm租期4OLimitTimes可使用次数4O订购”的情况下携带该参数。STBID终端 IDstring32OIPIP 地址string39OMAC终端的 MAC 地址,格式为::string17O响应消息包括以下参数:表 7更新 UserToken 返回参数说明7.1.4产品订购接口请求消息包含以下关键参数:表 8 基本
36、业务产品订购请求参数【ProductPurchaseReq】16名称说明数据长度是否承载协议:HTTP SOAP接口方向:基本业务能力业务管理接口功能:用户在基本业务能力上确定某产品后,通过调用本接口实现业务的订购。名称说明数据类型长度(字节)是否必选NewUserToken新的UserTokenString32MResult更新结果 0:成功 其他:失败String4MTokenExpiredTi meUserToken 的失效时间,格式为YYYYMMDDhhmimiss。缺少该参数表示永久有效。String14O名称说明数据类型长度(字节)是否必选OldUserToke n过期的 User
37、TokenString32MReturnURL更新 UserToken 后返回的 URL ,采用 URLEncoding 的 ANSI 方式string256MAction操作类型,此处使用:“UserTokenExpired”String20MSSP 的唯一标识String8OUserIDIPTV 用户业务string36O订购成功或取消订购结束后,基本业务能力返回处理页面给用户终端,通过 URL参数携带以下信息:表 9基本业务产品订购返回参数【ProductPurchaseResponse】17名称说明数据类型长度(字节)是否必选Result业务订购结果 0:成功 其他:失败String4
38、MServiceIDIPTV 服务string32MProductIDIPTV 产品string32MFee产品价格,以分为4MDescription结果描述String256OUserIDIPTV 用户业务string36OUserToken业务管理为该用户分配的临时明,可采用的方式传递string32OContentID内容 IDstring32OProductNameIPTV 产品名称String100OPurchaseType0:包月支付,用户选择订购产品后,按照固4O类型(字节)必选SSP 的唯一标识String8MContentID内容 IDString20MServiceIDIP
39、TV 服务String32MUserToken业务管理为该用户分配的临时明,可采用的方式传递String32MReturnURL返回EPG 服务页面的URLString256MAction操作类型:1:表示订购;2:表示退订。String20MUserIDIPTV 用户业务String36OProductIDIPTV 产品String32O7.1.5频道列表更新接口请求消息包含以下关键参数:表 10更新频道列表请求参数18名称说明数据类型长度(字节)是否必选UserIDIPTV 用户业务string36MReturnURL更新 UserToken 后返回的 URL ,采用 URLEncodin
40、g 的 ANSI 方式string256MAction操作类型,此处使用:“ChannelListUpdate”String20MChannelIDList需要更新的频道列表,采用”|”分隔的频道 ID列表,如 134|123|335String256MSSP 的唯一标识String8O承载协议:HTTP GET接口方向:基本业务能力业务管理接口功能:频道订购成功后,对频道列表进行更新定包月费用计费,在当月内无需再次向业务管理发起订购请求;1:按次支付,用户选择订购产品后,按照使用次数进行计费无需重新发起订购请求2:按次或包月,保留,暂时不用3:ppv,用户选择订购产品后,进行计费。再次使用时
41、仍需订购该产品 4:SVOD5:PVODSSP的唯一标识string8OTranionID订购的事务string40OExpiredTime订购关系的失效时间,格式为YYYYMMDDhhmmss。缺少该参数表示有效。String14O业务管理重定向返回,通过 URL 参数携带以下信息:表 11更新频道列表返回参数7.1.6产品包信息同步接口SOAP 接口请求消息 ProInfo 不包含任何信息。SOAP 接口响应消息 ProInfoResponse包含以下信息:表 12产品包信息获取响应 ProInfoResponse表 13 Product说明表 14 Service说明19名称说明数据类型
42、长度(字节)是否必选ProductIDIPTV 产品String32MServiceAmount服务数量4MService服务列表Service不定M名称说明数据类型长度(字节)是否必选ProductAmount产品数量4MProduct产品列表Product不定M承载协议:HTTP SOAP接口方向:基本业务能力业务管理接口功能:基本业务能力从业务管理获取产品包信息名称说明数据类型长度(字节)是否必选UserIDIPTV 用户业务string36MResult更新结果 0:成功 其他:失败String4MSSP 的唯一标识String8O7.1.7收藏接口用户在 IPTV 基本业务能力要求进
43、行收藏时,由 IPTV 基本业务能力向IPTV 业务管理提供的收藏夹进行的请求参数:表 15收藏参数7.1.8收藏夹接口用户从IPTV 基本业务能力问位于IPTV 业务管理上收藏夹时的请求参数:表 16收藏夹参数说明20名称说明数据类型长度(字节)是否必选承载协议:HTTP GET接口方向:基本业务能力业务管理接口功能:将用户从基本业务能力定位到 IPTV 业务管理上的收藏夹名称说明数据类型长度(字节)是否必选UserToken业务管理为该用户分配的临时明String32MContentID内容String32MReturnURL完成收藏后跳转的页面String2048M承载协议:HTTP G
44、ET接口方向:基本业务能力业务管理接口功能:完成用户对于基本业务能力上内容在 IPTV 业务管理上的收藏名称说明数据类型长度(字节)是否必选ServiceIDIPTV 服务string32M7.1.9已收藏接口通过 IPTV 业务管理详情介绍页面时在 URL 中填写的参上的收藏夹直接进行数:表 17收藏详情页面参数7.1.10书签同步接口21承载协议:HTTP SOAP接口方向:基本业务能力业务管理名称说明数据类型长度(字节)是否必选UserToken业务管理为该用户分配的临时身份证明String32MContentID需要详情页面的已后藏内容String32MReturnURLIPTV 业务
45、管理提供的收藏夹地址String2048M:详情页面要能够区分用户是由收藏夹跳转过来,需要业务管理上的收藏 夹地址,并允许当用户在本页面点击返回按键的时候,能够跳转回位于 IPTV 业务管理平如果用户的收藏内容不存在,则基本业务能力在 EPG 页面中显示错误代码:-5000,承载协议:HTTP GET接口方向:业务管理 基本业务能力接口功能:用户通过业务管理上收藏夹直接位于 IPTV 基本业务能力上的详情界面。UserToken业务管理为该用户分配的临时明String32MReturnURL完收藏夹后后跳转到 IPTV 基本业务能力的页面地址String2048MIPTV 基本业务能力将用户的
46、书签同步给 IPTV 业务管理的请求参数:表 18 书签同步请求【BookmarkReq】IPTV 业务管理返回的书签同步响应参数:表 19 书签同步响应【BookmarkResq】7.1.11书签反向同步接口书签反向同步请求参数:表 20 书签反向同步请求【BookmarkRevReq】22名称说明数据类型长度(字节)是否必选承载协议:HTTP SOAP接口方向:业务管理基本业务能力接口功能:业务管理向基本业务能力同步用户书签更新名称说明数据类型长度(字节)是否必选Result同步结果,“1”为成功,“0”为失败4MDescription对于同步结果的描述String36O:当正常结束后,业
47、务能力要通知业务管理删除书签,方式为ContentBM 的值为“-1”。名称说明数据类型长度(字节)是否必选UserToken业务管理为该用户分配的临时明String32MContentID内容String32MContentBM书签时间,根据类型的不同,该时间可采用 NPT 或格式进行。String16M书签反向同步响应参数:表 21 书签反向同步响应【BookmarkRevResq】7.1.12书签列表接口书签列表请求参数:表 22书签列表请求23名称说明数据类型长度(字节)是否必选ReturnURLIPTV 基本业务能力给出的业务管理平台书签列表后返回的地址String2048MUser
48、Token业务管理为该用户分配的临时明String32M承载协议:HTTP GET接口方向:基本业务能力业务管理接口功能:基本业务能力将用户书签列表前所在页面地址传给业务管理,并将用户重定向到书签页面,完成用户进入书签列表和退出返回的功能名称说明数据类型长度(字节)是否必选Result同步结果,“1”为成功,“0”为失败4MDescription对于同步结果的描述String36MUserID用户 IDString36MBMList内容与书签的列表BMList36MBMList 的结构ContentID内容String32MContentBM书签时间,根据类型的不同,该时间可采用NPT 或格式
49、进行。String16M7.1.13书签接口书签请求参数:表 23书签请求7.2扩展业务相关接口7.2.1用户重定向 SSO扩展业务重定向请求消息包含以下参数:表 24 业务重定向请求参数24承载协议:HTTP GET接口方向:扩展业务能力重定向业务管理接口功能:用户请求使用业务时,接收到 HTTP 重定向命令,要求重定向到业务管理平台的业务订购页面时触发,用户完成订购后,扩展业务能力保存订购信息,再返回处理页面给用户名称说明数据类型长度(字节)是否必选UserToken业务管理为该用户分配的临时明String32MContentID内容String32MContentBM书签时间,根据类型的
50、不同,该时间可采用 NPT 或格式进行。String16MReturnURLIPTV 业务管理签列表页面的String2048M】:如果用户的书签内容不存在,则基本业务能力在 EPG 页面中显示错误代码:-5000,表示内容不存在承载协议:HTTP GET接口方向:业务管理基本业务能力接口功能:可通过本接口在业务管理上的书签列表直接对于从书签处进行播放,的 URL 地址由 IPTV 基本业务能力提供。当用户退出是,应允许用户直接返回 IPTV 业务管理上的书签列表页面。重定向返回,通过 URL 参数携带以下信息:用户获取后,业务管理表 25业务重定向响应参数25名称说明数据类型长度(字节)是否
51、必选UserIDIPTV 用户业务string36MResult获取结果 0:成功 其他:失败String4MUserTokenIPTV 用户业务string36MSSP 的唯一标识string8OEPGGroupNMB用户对应的 EPG 分组信息标识string8OUserGroupNMB用户对应的分组信息标识string8ODescription结果描述String256OExpiredTim eUserToken 的失效时间,格式为YYYYMMDDhhmmss。缺少在一次开机过程中该参数表示有效。String14OReturnInfo返回扩展业务能力页面需要携带的额外信息,可用于区分不同
52、的 SSO 请求String256O名称说明数据类型长度(字节)是否必选SSP 的唯一标识string8MReturnURL返回扩展业务能力页面的 URLstring256MAction操作类型,目前仅当 Ses丢失重新获取用户时本参数为必选, 且此时填写为:UserTokenRequestString20OReturnInfo返回扩展业务能力页面需要携带的额外信息,可用于区分不同的 SSO 请求String256O7.2.2产品订购情况查询接口表 26扩展业务产品订购情况查询请求【ProductPuchasedReq】表 27扩展业务产品订购情况查询响应【ProductPuchasedRes
53、p】7.2.3产品详细查询接口26承载协议:HTTP SOAP接口方向:扩展业务能力业务管理接口功能:扩展业务能力向业务管理请求查询用户订购过的产品详细信息名称说明数据类型长度(字节)是否必选UserID用户登录业务帐号String36MEPGGroupNMB用户对应的 EPG 分组信息标识String8MSTBID终端 IDString32OMAC终端的 MAC 地址,格式为:String17OProducts用户已的扩展业务 IPTV 产品,多个用”,”分隔String255OS扩展业务 SP 的,如为空,则查询所有SP 的产品订购信息String8O名称说明数据类型长度(字节)是否必选U
54、serToken业务管理为该用户分配的临时明String32MUserID用户登录业务帐号String36OS扩展业务 SP 的,如为空,则查询所有 SP的产品订购信息String8O承载协议:HTTP SOAP接口方向:扩展业务能力业务管理接口功能:扩展业务能力向业务管理请求查询用户订购过的所有产品信息表 28 扩展业务产品详细查询请求【ProdDetailQueryReq】表 29扩展业务产品详细查询响应【ProdDetailQueryResponse】7.2.4产品订购接口扩展业务产品订购请求消息包含以下关键参数:表 30 扩展业务订购请求27承载协议:HTTP GET接口方向:扩展业务
55、能力业务管理接口功能:用户在 IPTV 业务管理上订购扩展业务产品名称说明数据类型长度(字节)是否必选ProductID产品 IDString32MProductName产品名String100MProductDesc产品描述String200OPurchaseType0:包月支付,用户选择订购产品后,按照固定包月费用计费,在当月内无需再次向业务管理 发起订购请求;1:按次支付,用户选择订购产品后,按照使用次数进行计费无需重新发起订购请求2:按次或包月,保留,暂时不用3:ppv,用户选择订购产品后,进行计费。再次使用时仍需订购该产品 4:SVOD5:PVOD4OFee支付金额(以分为)4OEP
56、GGroupNMB产品使用的 EPG 分组String8O名称说明数据类型长度(字节)是否必选ProductID产品 IDString32MS扩展业务 SP 的String8O,通过 URL订购成功或取消订购结束后,业务管理重定向返回扩展业务能力参数携带以下信息:表 31扩展业务订购响应28名称说明数据类型长度(字节)是否必选Result业务订购结果 0:成功 其他:失败String4MServiceIDIPTV 服务string32MProductIDIPTV 产品string32MFee产品价格,以分为4MDescription结果描述String256OUserIDIPTV 用户业务string36OUserToken业务管理为该用户分配的临时明,可采用的方式传递string32OContentID内容 IDstring32OProductNameIPTV 产品名称String10
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 二零二四年度路灯及相关设备租赁合同
- 二零二四年度汽车零部件出口合同
- 美容师劳动合同模板2024年度2
- 医院污水处理系统保养合同
- 煤炭运输合同管理方案
- 矿山开发项目管架搭建方案
- 校外辅导班假期出入控制办法
- 医院员工职业健康评估的规章制度
- 新能源汽车充电设备销售合同
- 市直部门工作考核方案(2篇)
- 合同到期欠款补充协议
- 本科层次职业教育装备制造类专业新形态教材建设研究
- 冬季出行安全主题班会
- 2024年学生公寓住宿协议
- 幼儿园安全守护制度
- 语文-湖南(河南)省湘豫名校联考2024年11月2025届高三上学期一轮复习诊断考试暨期中考试试题和答案
- 期中测试卷(试题)-2024-2025学年一年级上册语文统编版
- 国开(内蒙古)2024年《创新创业教育基础》形考任务1-3终考任务答案
- 工法样板展示施工方案
- 盾构施工关键技术知识考试题库及答案
- 2024无障碍环境建设法知识竞赛题库及答案
评论
0/150
提交评论