IPTV业务管理平台与业务系统接口技术

文件编号：SHDX/ZS/CZ/JG/002/A/2008

中国电信集团上海市电信公司

IPTV业务管理平台与业务系统接口技术规范V2.2

1目的

本规范是在中国电信集团公司发布的《IPTV业务管理平台与业务系统接口技术规范V2.0》的基础上，根据中国电信上海公司IPTV运营的实际情况，进一步调整修订而成的。

本规范供引入IPTV能力平台设备、IPTV业务管理平台设备时参照执行。

本技术规范的增补、修订和解释权归中国电信上海公司所有。如中国电信上海公司在此之前的文件与本技术规范有矛盾，按此技术规范执行。

本技术规范自发布之日起实施。

2适用范围

本规范规定了IPTV业务管理平台与业务系统之间的接口。本规范适用于IPTV业务管理平台、EPG服务系统、内容分发系统之间的接口开发。为中国电信上海公司IPTV机顶盒和平台的接口开放的测试提供依据。为中国电信上海公司IPTV能力平台设备、IPTV业务管理平台设备的选择提供了依据。

3引用文件/标准

下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。

RFC2616: Hypertext Transfer Protocol

RFC3275: Extensible Makeup Language

W3C: Web Services Description Language

《IPTV业务管理平台技术规范》

4定义/术语

EPG Electronic Programmer Guide 电子节目单

HTTP Hypertext Transfer Protocol 超文本传输协议

IP Internet Protocol 网络协议

MAC Media Access Control 媒体访问控制层

SOAP Simple Object Access Protocol 简单对象访问协议

STB Set Top Box 机顶盒

URL Uniform Resource Locator 统一资源定位符

5IPTV业务管理平台与业务系统接口

5.1总体框架

业务系统包括EPG服务系统、内容分发系统、增值业务系统和其他IPTV的业务系统，IPTV业务管理平台与业务系统的总体框架如图所示：

图5-1-1：IPTV业务管理平台与业务系统框架图

IPTV业务管理平台与业务系统接口包括以下接口：

a)EPG首页鉴权接口

●接口描述：本接口在用户访问EPG首页时，EPG服务系统向业

务管理平台请求鉴权。

●承载协议：SOAP

b)UserToken更新接口

●接口描述：本接口在用户令牌UserToken（参见《机顶盒与IPTV

业务运营平台接口技术规范》）失效时，EPG服务系统重定向到业

务管理平台请求新的UserToken。

●承载协议：HTTP

c)Session丢失后获取接口

●接口描述：本接口机顶盒访问EPG平台时，EPG平台通过

Session（或cookie）记忆用户的临时身份凭证（UserToken）。但是，由于Session（或Cookie）的时限性，使得机顶盒在一段时间内没有访问EPG页面时，机顶盒将丢失与EPG之间的Session，从而使得EPG丢失用户的UserToken，无法继续为该用户机顶盒提供IPTV服务。

●承载协议：HTTP

d)业务鉴权接口

●接口描述：本接口在用户通过EPG请求业务资源时，EPG服务

系统向业务管理平台请求业务鉴权，业务管理平台将鉴权结果返回给EPG服务系统。

●承载协议：SOAP

e)业务订购接口

●接口描述：本接口在用户请求使用业务时，EPG服务系统向业

务管理平台请求业务订购，用户完成订购后，EPG服务系统保存订购信息，再返回处理页面给用户。

●承载协议：SOAP

f)直播频道列表更新接口

●接口描述：本接口在用户请求订购直播频道，当业务管理平台

返回订购成功响应后，EPG服务系统将用户重定向至业务管理平台，要求重新设置直播频道列表。业务管理平台通过CTCSetConfig 设置订购成功的频道列表，并将机顶盒重定向至EPG服务系统。

●承载协议：HTTP

g)产品包信息获取接口

●接口描述：本接口为EPG服务系统向业务管理平台请求产品

包信息，业务管理系统将产品包信息返回给EPG服务系统。

●承载协议：SOAP

h)用户身份重定向接口

●接口描述：本接口在用户请求使用业务时，接收到HTTP重定

向命令，要求重定向到业务管理平台的业务订购页面时触发，用户完成订购后，EPG服务系统保存订购信息，再返回处理页面给用户。

●承载协议：HTTP

i)增值业务订购查询接口

●接口描述：增值业务平台向业务管理平台请求查询用户订购过

的所有产品信息。

●承载协议：SOAP

j)增值业务产品详细信息查询接口

●接口描述：增值业务平台向业务管理平台请求查询用户订购过

的产品详细信息。

●承载协议：SOAP

k)增值业务产品订购接口

●接口描述：当用户选择订购某增值业务时，增值业务平台将用

户重定向至业务管理平台进行该增值业务的订购。当用户订购成功后，业务管理平台能将用户重定向回增值业务平台显示订购结果。

●承载协议：HTTP

l)业务能力系统数据采集接口

●接口描述：为了进行IPTV业务的经营分析需要向IPTV平台采

集相关数据。

●承载协议：FTP

（【注】当业务能力平台、增值业务系统与业务管理平台进行横向SOAP接口进行交互时，能够对横向接口连接情况进行监测，并在横向接口连接时间超过10s的情况下通过错误提示页面告知用户，并要求机顶盒重新发起认证请求。）

5.2 EPG 首页鉴权接口 5.2.1 接口时序

图5-2-1-1：EPG 首页鉴权流程

5.2.2 接口协议内容

SOAP 接口请求消息EPGAuth 包含如下信息：

表5-2-2-1：请求EPGAuth

SOAP 接口应答消息EPGAuthResponse 包含以下信息：

表5-2-2-2：响应

EPGAuthResponse

5.3UserToken更新接口

5.3.1接口时序

图5-3-1-1：UserToken更新流程图

用户UserToken更新过程如下：

a)STB向EPG服务系统发起http请求。

b)EPG服务系统检查UserToken是否过期，如果未过期，则跳转

到c，如果已过期，则跳转到e。

c)EPG服务系统响应请求。

d)UserToken已过期。

e)EPG服务系统将用户请求重定向到业务管理平台，请求新的

UserToken，请求参数ReturnURL,OldUserToken，Action。

f)如业务管理平台需要STB重新认证或发生频道更改需要更新频

道列表，则下发重认证页面或频道更新页面；

g)STB重新认证或更新频道结束后，由页面逻辑控制发起重定向

请求；

h)业务管理平台返回新的UserToken，返回参数NewUserToken、

Result。

（【注】：IPTV业务能力平台在完成用户UserToken更新后都应该再次发起首页鉴权请求，以保证当前用户已订购产品列表为最新且可用的。）

5.3.2接口协议内容

请求消息包含以下关键参数

表5-3-2-1：更新UserToken请求参数说明

响应消息

表5-3-2-2：更新UserToken返回参数说明

5.4Session丢失后获取接口

机顶盒访问EPG平台时，EPG平台通过Session（或cookie）记忆

用户的临时身份凭证（UserToken）。但是，由于Session（或Cookie）的时限性，使得机顶盒在一段时间内没有访问EPG页面时，机顶盒将丢失与EPG之间的Session，从而使得EPG丢失用户的UserToken，无法继续为该用户机顶盒提供IPTV服务。

5.4.1接口时序

为了解决这一问题，可以采用SSO流程获取用户的UserToken。以下是机顶盒与EPG交互、Session丢失和EPG处理流程：

a).机顶盒开机认证通过，业务管理平台为其分配临时身份凭证

UserToken

b).机顶盒访问EPG首页，携带UserToken

c).EPG以Session（或Cookie）方式保存用户的UserToken

d).EPG在调用业务管理平台的业务鉴权、产品订购时必需携带有

效的UserToken。EPG通过UserToken更新机制来保证UserToken

的有效性。

e).机顶盒通过访问EPG页面来维持机顶盒与EPG之间的Session

有效。机顶盒在一段时间内没有操作或者机顶盒离开EPG访问

增值业务，超过Session的超时时限，机顶盒丢失与EPG之间

的Session。

f).机顶盒再次访问EPG，EPG因Session丢失，无法获得机顶盒

的UserToken

g).EPG系统将机顶盒重定向到业务管理系统，发起用户身份重定

向SSO请求, 携带ReturnURL等参数

h).业务管理平台获取机顶盒的UserToken后，通过通过重定向携

带参数方式，将UserToken等参数返回给EPG系统

i).EPG获得用户身份，继续为用户提供服务。

5.4.2接口协议内容

业务身份重定向SSO请求参数：

表5-4-2-1：业务身份重定向SSO请求参数说明

业务身份重定向SSO返回参数：

表5-4-2-2：业务身份重定向SSO响应参数说明

5.5业务鉴权

5.5.1接口时序

业务鉴权接口时序流程如下：

图5-4-1-1：业务鉴权流程图

a)终端访问业务系统的业务使用入口，请求使用某项业务；

b)业务系统要求鉴权，发起到业务管理平台的SOAP请求，携带

ProductID、UserToken等信息；

c)业务管理平台根据产品、用户信息进行业务鉴权；

d)业务管理平台通过SOAP响应返回鉴权结果；

e)如果鉴权未通过，则业务系统发起业务订购的流程；

f)如果鉴权通过，则业务系统允许使用；

g)业务系统返回用户请求的实际业务内容，继续业务的使用。

5.5.2接口协议内容

表5-4-2-1：业务鉴权请求ServiceAuthReq

表5-4-2-2：业务鉴权请求响应

5.6业务订购

5.6.1接口时序

图5-5-1-1：即时业务订购流程图5.6.2接口协议内容

请求消息包含以下关键参数

表5-5-2-1：业务订购请求参数

业务管理平台返回的响应消息携带以下参数：

表5-5-2-2：SOAP响应消息