




版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
1、文件编号:SHDX/ZS/CZ/JG/002/A/2008中国电信集团上海市电信公司IPTV业务管理平台与业务系统接口技术规范V2.21 目的本规范是在中国电信集团公司发布的IPTV业务管理平台与业务系统接口技术规范V2.0的基础上,根据中国电信上海公司IPTV运营的实际情况,进一步调整修订而成的。本规范供引入IPTV能力平台设备、IPTV业务管理平台设备时参照执行。本技术规范的增补、修订和解释权归中国电信上海公司所有。如中国电信上海公司在此之前的文件与本技术规范有矛盾,按此技术规范执行。本技术规范自发布之日起实施。2 适用范围本规范规定了IPTV业务管理平台与业务系统之间的接口。本规范适用于
2、IPTV业务管理平台、EPG服务系统、内容分发系统之间的接口开发。为中国电信上海公司IPTV机顶盒和平台的接口开放的测试提供依据。为中国电信上海公司IPTV能力平台设备、IPTV业务管理平台设备的选择提供了依据。3 引用文件/标准下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。RFC2616: Hypertext Transfer ProtocolRFC3275: Extensible Ma
3、keup LanguageW3C: Web Services Description LanguageIPTV业务管理平台技术规范4 定义/术语EPGElectronic Programmer Guide电子节目单HTTPHypertext Transfer Protocol超文本传输协议IP Internet Protocol 网络协议 MAC Media Access Control 媒体访问控制层SOAPSimple Object Access Protocol 简单对象访问协议STBSet Top Box机顶盒URL Uniform Resource Locator 统一资源定位符5
4、IPTV业务管理平台与业务系统接口5.1 总体框架业务系统包括EPG服务系统、内容分发系统、增值业务系统和其他IPTV的业务系统,IPTV业务管理平台与业务系统的总体框架如图所示:业务管理平台EPG服务系统内容分发系统其他业务系统业务系统增值业务系统图5-1-1:IPTV业务管理平台与业务系统框架图IPTV业务管理平台与业务系统接口包括以下接口:a) EPG首页鉴权接口l 接口描述:本接口在用户访问EPG首页时,EPG服务系统向业务管理平台请求鉴权。l 承载协议:SOAPb) UserToken更新接口l 接口描述:本接口在用户令牌UserToken(参见机顶盒与IPTV业务运营平台接口技术规
5、范)失效时,EPG服务系统重定向到业务管理平台请求新的UserToken。l 承载协议:HTTPc) Session丢失后获取接口l 接口描述:本接口机顶盒访问EPG平台时,EPG平台通过Session(或cookie)记忆用户的临时身份凭证(UserToken)。但是,由于Session(或Cookie)的时限性,使得机顶盒在一段时间内没有访问EPG页面时,机顶盒将丢失与EPG之间的Session,从而使得EPG丢失用户的UserToken,无法继续为该用户机顶盒提供IPTV服务。l 承载协议:HTTPd) 业务鉴权接口l 接口描述:本接口在用户通过EPG请求业务资源时,EPG服务系统向业务
6、管理平台请求业务鉴权,业务管理平台将鉴权结果返回给EPG服务系统。l 承载协议:SOAPe) 业务订购接口l 接口描述:本接口在用户请求使用业务时,EPG服务系统向业务管理平台请求业务订购,用户完成订购后,EPG服务系统保存订购信息,再返回处理页面给用户。l 承载协议:SOAPf) 直播频道列表更新接口l 接口描述:本接口在用户请求订购直播频道,当业务管理平台返回订购成功响应后,EPG服务系统将用户重定向至业务管理平台,要求重新设置直播频道列表。业务管理平台通过CTCSetConfig设置订购成功的频道列表,并将机顶盒重定向至EPG服务系统。l 承载协议:HTTPg) 产品包信息获取接口l 接
7、口描述:本接口为EPG服务系统向业务管理平台请求产品包信息,业务管理系统将产品包信息返回给EPG服务系统。l 承载协议:SOAPh) 用户身份重定向接口l 接口描述:本接口在用户请求使用业务时,接收到HTTP重定向命令,要求重定向到业务管理平台的业务订购页面时触发,用户完成订购后,EPG服务系统保存订购信息,再返回处理页面给用户。l 承载协议:HTTPi) 增值业务订购查询接口l 接口描述:增值业务平台向业务管理平台请求查询用户订购过的所有产品信息。l 承载协议:SOAPj) 增值业务产品详细信息查询接口l 接口描述:增值业务平台向业务管理平台请求查询用户订购过的产品详细信息。l 承载协议:S
8、OAPk) 增值业务产品订购接口l 接口描述:当用户选择订购某增值业务时,增值业务平台将用户重定向至业务管理平台进行该增值业务的订购。当用户订购成功后,业务管理平台能将用户重定向回增值业务平台显示订购结果。l 承载协议:HTTPl) 业务能力系统数据采集接口l 接口描述:为了进行IPTV业务的经营分析需要向IPTV平台采集相关数据。l 承载协议:FTP(【注】当业务能力平台、增值业务系统与业务管理平台进行横向SOAP接口进行交互时,能够对横向接口连接情况进行监测,并在横向接口连接时间超过10s的情况下通过错误提示页面告知用户,并要求机顶盒重新发起认证请求。)5.2 EPG首页鉴权接口5.2.1
9、 接口时序STB业务管理平台a)HTTP请求d)HTTP响应EPG服务系统b)SOAP请求c)SOAP响应图5-2-1-1:EPG首页鉴权流程5.2.2 接口协议内容承载协议:SOAP接口方向:EPG服务系统 业务管理平台接口功能:EPG服务系统向业务管理平台请求鉴权,通过鉴权后再给用户下发EPG首页SOAP接口请求消息EPGAuth包含如下信息: 表5-2-2-1:请求EPGAuth名称说明数据类型长度(字节)是否必选UserToken业务管理平台为该用户分配的临时身份证明String32MSOAP接口应答消息EPGAuthResponse包含以下信息:表5-2-2-2:响应EPGAuthR
10、esponse名称说明数据类型长度(字节)是否必选UserIDIPTV用户业务编号String36MResult结果,0:成功 其他:失败String4MDescription结果描述String256OUserGroupNMB用户对应的用户分组信息标识String8OEPGGroupNMB用户对应的EPG分组信息标识String8MSTBID机顶盒编号string32OMAC机顶盒的MAC地址,格式为:xx:xx:xx:xx:xx:xxString13OProducts用户已购买的IPTV 产品编号组合,组合间采用”;”分隔,组合内采用”,”分隔,分别为产品ID,内容ID,可以为以下情形:1
11、、 ProductID:表示整个产品的订购关系,且有效期未知;2、 ProductID,ExpiredTime :表示整个产品的订购关系,且存在有效期;3、 ProductID,ContentID:未知有效期的内容订购关系,如ContentID 为直播频道ID,则为直播频道订购关系,如为点播内容ID,则为点播内容订购关系;4、 ProductID,ExpiredTime,ContentID:存在有效期的内容订购关系, 如ContentID 为直播频道ID,则为直播频道订购关系,如为点播内容ID,则为点播内容订购关系。String不定OTokenExpiredTimeUserToken的失效时间
12、, 格式为:YYYYMMDDhhmmss。缺少该参数表示在一次登录期间,永久有效。String14O5.3 UserToken更新接口5.3.1 接口时序STBEPG服务系统业务管理平台a)Http请求b)UserToken 未过期c)Http响应d)UserToken 已过期e)重定向h)返回新的UserTokenf)频道更新或重认证g)频道更新或重认证结束请求图5-3-1-1:UserToken更新流程图用户UserToken更新过程如下:a) STB向EPG服务系统发起http请求。b) EPG服务系统检查UserToken是否过期,如果未过期,则跳转到c,如果已过期,则跳转到e。c)
13、EPG服务系统响应请求。d) UserToken已过期。e) EPG服务系统将用户请求重定向到业务管理平台,请求新的UserToken,请求参数ReturnURL,OldUserToken,Action。f) 如业务管理平台需要STB重新认证或发生频道更改需要更新频道列表,则下发重认证页面或频道更新页面;g) STB重新认证或更新频道结束后,由页面逻辑控制发起重定向请求;h) 业务管理平台返回新的UserToken,返回参数NewUserToken、Result。(【注】:IPTV业务能力平台在完成用户UserToken更新后都应该再次发起首页鉴权请求,以保证当前用户已订购产品列表为最新且可用
14、的。)5.3.2 接口协议内容承载协议:HTTP GET接口方向:EPG服务系统重定向 业务管理平台接口功能:UserToken失效时,EPG服务系统重定向到业务管理平台请求新的UserToken。请求消息包含以下关键参数表5-3-2-1:更新UserToken请求参数说明名称说明数据类型长度(字节)是否必选SPIDSP的唯一标识String8OUserIDIPTV用户业务编号string36OOldUserToken过期的UserTokenString32MReturnURL更新UserToken后返回的URL,采用URLEncoding的ANSI方式string256MAction操作类型
15、,此处使用:“UserTokenExpired”String20M响应消息表5-3-2-2:更新UserToken返回参数说明名称说明数据类型长度(字节)是否必选SPIDSP的唯一标识String8OUserIDIPTV用户业务编号string36MNewUserToken新的UserTokenString32MResult更新结果 0:成功 其他:失败String4MTokenExpiredTimeUserToken的失效时间,格式为:YYYYMMDDhhmmss。缺少该参数表示永久有效。String14O5.4 Session丢失后获取接口机顶盒访问EPG平台时,EPG平台通过Sessio
16、n(或cookie)记忆用户的临时身份凭证(UserToken)。但是,由于Session(或Cookie)的时限性,使得机顶盒在一段时间内没有访问EPG页面时,机顶盒将丢失与EPG之间的Session,从而使得EPG丢失用户的UserToken,无法继续为该用户机顶盒提供IPTV服务。5.4.1 接口时序为了解决这一问题,可以采用SSO流程获取用户的UserToken。以下是机顶盒与EPG交互、Session丢失和EPG处理流程:a). 机顶盒开机认证通过,业务管理平台为其分配临时身份凭证UserTokenb). 机顶盒访问EPG首页,携带UserTokenc). EPG以Session(或
17、Cookie)方式保存用户的UserTokend). EPG在调用业务管理平台的业务鉴权、产品订购时必需携带有效的UserToken。EPG通过UserToken更新机制来保证UserToken的有效性。e). 机顶盒通过访问EPG页面来维持机顶盒与EPG之间的Session有效。机顶盒在一段时间内没有操作或者机顶盒离开EPG访问增值业务,超过Session的超时时限,机顶盒丢失与EPG之间的Session。f). 机顶盒再次访问EPG,EPG因Session丢失,无法获得机顶盒的UserTokeng). EPG系统将机顶盒重定向到业务管理系统,发起用户身份重定向SSO请求, 携带Return
18、URL等参数h). 业务管理平台获取机顶盒的UserToken后,通过通过重定向携带参数方式,将UserToken等参数返回给EPG系统i). EPG获得用户身份,继续为用户提供服务。5.4.2 接口协议内容承载协议:HTTP SSO接口方向:EPG服务系统 业务管理平台接口功能:采用SSO流程获取用户的UserToken。业务身份重定向SSO请求参数:表5-4-2-1:业务身份重定向SSO请求参数说明名称说明数据类型长度(字节)是否必选SPIDSP的唯一标识string8MReturnURL返回增值业务系统页面的URLstring256MReturnInfo返回增值业务系统页面需要携带的额外
19、信息,可用于区分不同的SSO请求string256OAction操作类型,此处使用:UserTokenRequeststring20M业务身份重定向SSO返回参数:表5-4-2-2:业务身份重定向SSO响应参数说明名称说明数据类型长度(字节)是否必选Result身份获取结果0:成功;其他:失败string4MUserTokenIPTV用户业务编号string36MSPIDSP的唯一标识string8OUserIDIPTV用户业务编号string36OEPGGroupNMB用户对应的EPG分组信息标识string8OUserGroupNMB用户对应的分组信息标识string8ODescripti
20、on结果描述string256OExpiredTimeUserToken的失效时间,格式为YYYYMMDDhhmmss。缺少在一次开机过程中该参数表示永久有效。string14OReturnInfo返回EPG页面需要携带的额外信息,可用于区分不同的SSO请求string256O5.5 业务鉴权5.5.1 接口时序业务鉴权接口时序流程如下:图5-4-1-1:业务鉴权流程图a) 终端访问业务系统的业务使用入口,请求使用某项业务;b) 业务系统要求鉴权,发起到业务管理平台的SOAP请求,携带ProductID、UserToken等信息;c) 业务管理平台根据产品、用户信息进行业务鉴权;d) 业务管理
21、平台通过SOAP响应返回鉴权结果;e) 如果鉴权未通过,则业务系统发起业务订购的流程;f) 如果鉴权通过,则业务系统允许使用;g) 业务系统返回用户请求的实际业务内容,继续业务的使用。5.5.2 接口协议内容承载协议:SOAP接口方向:业务系统 业务管理平台接口功能:业务系统向业务管理平台请求使用业务表5-4-2-1:业务鉴权请求ServiceAuthReq 名称说明数据类型长度(字节)是否必选SPID增值业务SP的编号,基本业务鉴权时无效String8OUserID用户登录业务帐号String36OUserToken业务管理平台为该用户分配的临时身份证明,这里通过EPG上传给业务管理平台St
22、ring32MProductIDIPTV产品编号String32MServiceIDIPTV服务编号String32OContentIDIPTV内容编号String32MTimeStamp从1970年1月1日0时开始的毫秒数digit string<=18MIPIP地址String39OMAC机顶盒的MAC地址,格式为:xx:xx:xx:xx:xx:xxString17OTransactionID事务编号string40O表5-4-2-2:业务鉴权请求响应名称说 明数据类型长度(字节)是否必选Result0:成功其他:失败String4MUserID用户登录业务帐号String36OPr
23、oductID产品IDString32MServiceID服务IDString32O ContentID内容IDString32M STBID机顶盒IDstring32OIPIP地址string39OMAC机顶盒的MAC地址,格式为:xx:xx:xx:xx:xx:xxstring17OTransactionID事务编号string40OExpiredTime本订购关系的鉴权失效时间,用绝对时间表示。格式为:YYYYMMDDhhmmss。如本参数为空,则表示该订购关系的鉴权长期有效;如本参数为当前时间,则表示该订购关系的鉴权一次性有效。String14OBalance预付费用户余额,单位为分。如
24、为后付费用户,该参数缺失或为空int4OProductList可订购的产品列表,在订购失败并返回“用户未订购”的情况下携带该参数。Product不定O表5-4-2-2:Product 结构名称说 明数据类型长度(字节)是否必选ProductID产品IDString32MProductName产品名称String100MFee产品价格,以分为单位Int4MPurchaseType0:包月支付,用户选择订购产品后,按照固定包月费用计费,在当月内无需再次向业务管理平台发起订购请求;1:按次支付,用户选择订购产品后,按照使用次数进行计费无需重新发起订购请求2:免费3:ppv,用户选择订购产品后,进行一
25、次性计费。再次使用时仍需订购该产品4:SVOD;5:PVOD;Int4OProductDesc产品描述String200OListPrice标称价格,以分为单位Int4ORentalTerm租期Int4OLimitTimes可使用次数Int4O5.6 业务订购5.6.1 接口时序STB业务系统业务管理平台a)订购请求b)业务订购请求c)返回订购响应e)返回处理页面d)保存订购信息图5-5-1-1:即时业务订购流程图5.6.2 接口协议内容承载协议:SOAP接口方向:EPG服务系统 业务管理平台接口功能:用户订购业务请求消息包含以下关键参数表5-5-2-1:业务订购请求参数名称说明数据类型长度(
26、字节)是否必选SPIDSP的唯一标识string8OUserIDIPTV用户业务编号string36OUserToken业务管理平台为该用户分配的临时身份证明,可采用Cookie的方式传递string32MContentID内容IDstring32MServiceIDIPTV服务编号string32OProductIDIPTV产品编号string32MAction操作类型:1:表示订购;2:表示退订。String20M业务管理平台返回的响应消息携带以下参数:表5-5-2-2:SOAP响应消息名称说明数据类型长度(字节)是否必选Result业务订购结果 0:成功 其他:失败String4MDes
27、cription结果描述String256OUserIDIPTV用户业务编号string36OUserToken业务管理平台为该用户分配的临时身份证明,可采用Cookie的方式传递string32OContentID内容IDstring32M ServiceIDIPTV服务编号string32OProductIDIPTV产品编号string32MSPIDSP的唯一标识string8OTransactionID订购的事务编号string40OExpiredTime订购关系的失效时间, 格 式 为YYYYMMDDhhmmss。缺少该参数表示永久有效。String14OBalance预付费用户的费用
28、余额,单位为分。如为后付费用户,该参数缺失或为空。Int4OFee产品价格,以分为单位Int4MPurchaseType0:包月支付,用户选择订购产品后,按照固定包月费用计费,在当月内无需再次向业务管理平台发起订购请求;1:按次支付,用户选择订购产品后,按照使用次数进行计费无需重新发起订购请求2:免费3:ppv,用户选择订购产品后,进行一次性计费。再次使用时仍需订购该产品4:SVOD5:PVODInt4O5.7 直播频道列表更新接口5.7.1 接口时序STBEPG服务系统业务管理平台a)直播频道成功订购流程b)重定向,设置新的频道列表c)频道更新响应图5-6-1-1:直播频道列表更新流程图a)
29、 STB通过业务订购接口完成对于直播频道的订购,并通过直播订购接口步骤 7 返回订购成功的响应。b) EPG服务系统将用户重定向至业务管理平台,要求重新设置直播频道列表。c) 业务管理平台通过CTCSetConfig设置订购成功的频道列表,并将机顶盒重定向至EPG服务系统。5.7.2 接口协议内容承载协议:HTTP GET接口方向:EPG服务系统重定向 业务管理平台接口功能:直播频道订购成功后,对直播频道列表进行更新请求消息包含以下关键参数表5-6-2-1:更新直播频道列表请求参数说明名称说明数据类型长度(字节)是否必选SPIDSP的唯一标识String8OUserIDIPTV用户业务编号st
30、ring36MReturnURL更新UserToken后返回的URL,采用URLEncoding的ANSI方式string256MAction操作类型,此处使用:“ChannelListUpdate”String20MChannelIDList需要更新的频道列表,采用”|”分隔的频道ID列表,如134|123|335String256M业务管理系统重定向返回,通过URL参数携带以下信息表5-6-2-2:更新直播频道列表返回参数说明名称说明数据类型长度(字节)是否必选SPIDSP的唯一标识String8OUserIDIPTV用户业务编号string36MResult更新结果 0:成功 其他:失败
31、String4M5.8 产品包信息获取接口业务管理平台EPG服务系统a)产品包获取请求b)产品包获取响应5.8.1 接口时序图5-7-1-1:产品包信息获取流程图5.8.2 接口协议内容承载协议:SOAP接口方向:EPG服务系统 业务管理平台接口功能:EPG服务系统从业务管理平台获取产品包信息。SOAP接口请求消息ProInfo不包含任何信息。SOAP接口响应消息ProInfoResponse,需要包含以下信息:表5-7-2-1:响应ProInfoResponse名称说明数据类型长度(字节)是否必选ProductAmount产品数量Int4MProduct产品列表Product见表5-6-2-
32、2Product说明M表5-7-2-2: Product说明名称说明数据类型长度(字节)是否必选ProductIDIPTV产品编号String32MServiceAmount服务数量Int4MService服务列表Service见表5-7-2-3Service说明M表5-7-2-3: Service说明名称说明数据类型长度(字节)是否必选ServiceIDIPTV服务编号string32M5.9 增值业务认证鉴权STB增值业务系统业务管理平台a)首次访问b)SSO获取用户身份c)查询增值业务订购信息f)增值业务鉴权d)增值业务访问g)业务使用e)业务订购图5-9-1:即时业务订购流程图a) 用
33、户首次访问增值业务系统;b) 增值业务系统通过SSO过程获取用户身份,参见5.7.1;c) 增值业务系统查询增值业务订购信息,参见5.7.2;d) 用户进行增值业务访问;e) 如用户未订购业务,则要求用户进行订购,参见5.5;f) 增值业务系统进行业务鉴权,参见5.4;g) 用户使用增值业务。5.9.1 用户身份重定向(SSO) 接口时序STB增值业务系统业务管理平台a)业务请求b)检测到UserTokenc)请求响应d)未检测到UserTokene)HTTP重定向f)SSO返回新的UserToken图5-9-1-1-1:重定向认证用户身份流程在用户首次访问增值业务系统无法判断用
34、户身份时,使用该SSO重定向过程获取UserToken以判定用户身份:a) 用户访问增值业务系统/IPTV业务系统;b) 增值业务系统检测UserToken;c) 如增值业务系统检测到合法UserToken,则返回正常使用响应;d) 增值业务系统无法获取UserToken,则开始重定向过程;e) 增值业务系统将用户重定向到业务管理平台,携带ReturnURL等参数;f) 业务管理平台检查用户cookie获取UserToken,如果没有检测到,通过重新认证产生UserToken(参见5.3),并通过重定向参数方式,将UserToken等参数返回给增值业务系统。 接口协议内容承载协议
35、:SSO接口方向:增值业务系统 业务管理平台接口功能:在用户首次访问增值业务系统无法判断用户身份时,使用该SSO重定向过程获取UserToken以判定用户身份。请求消息包含以下参数表5-9-1-2-1:业务身份重定向请求参数名称说明数据类型长度(字节)是否必选SPIDSP的唯一标识string8MReturnURL返回增值业务系统页面的URLstring256MReturnInfo返回增值业务系统页面需要携带的额外信息,可用于区分不同的SSO请求String256OAction操作类型,此处使用:UserTokenRequestString20M用户身份获取后,业务管理系统重定向返回,通过UR
36、L参数携带以下信息:表5-9-1-2-2 关键信息名称说明数据类型长度(字节)是否必选SPIDSP的唯一标识string8OUserIDIPTV用户业务编号string36OEPGGroupNMB用户对应的EPG分组信息标识string8OUserGroupNMB用户对应的分组信息标识string8OResult身份获取结果 0:成功 其他:失败String4MDescription结果描述String256OUserTokenIPTV用户业务编号string36MExpiredTimeUserToken的失效时间, 格 式 为YYYYMMDDhhmmss。缺少在一次开机过程中该参数表示永久有
37、效。String14OReturnInfo返回增值业务系统页面需要携带的额外信息,可用于区分不同的SSO请求String256O5.9.2 增值业务订购查询接口承载协议:SOAP接口方向:增值业务系统 业务管理平台接口功能:增值业务平台向业务管理平台请求查询用户订购过的所有产品信息。表5-9-2-1 增值业务产品订购查询请求参数名称说明数据类型长度(字节)是否必选UserToken业务管理平台为该用户分配的临时身份证明String32MUserID用户登录业务帐号String36OSPID增值业务SP的编号,如为空,则查询所有SP的产品订购信息String8O表5-9-2-2 增值业务产品订购
38、查询请求响应名称说明数据类型长度(字节)是否必选UserID用户登录业务帐号String36MEPGGroupNMB用户对应的EPG分组信息标识String8MSTBID机顶盒ID,详见第6章String32OMAC机顶盒的MAC地址,格式为:xx:xx:xx:xx:xx:xxString17OProducts用户已购买的增值业务IPTV产品编号,多个用”,”分隔String255OSPID增值业务SP的编号,如为空,则查询所有SP的产品订购信息String8O5.9.3 增值业务产品详细查询承载协议:SOAP接口方向:增值业务系统 业务管理平台接口功能:增值业务系统向业务管理平台请求查询用户
39、订购过的产品详细信息。表5-9-3-1 查询产品详细信息请求ProdDetailQueryReq名称说明数据类型长度(字节)是否必选ProductID产品IDString32MSPID增值业务SP的编号String8O表5-8-3-2 查询产品详细信息请求响应名称说明数据类型长度(字节)是否必选ProductID产品IDString32MProductName产品名String100MProductDesc产品描述String200OPurchaseType0:包月支付,用户选择订购产品后,按照固定包月费用计费,在当月内无需再次向业务管理平台发起订购请求;1:按次支付,用户选择订购产品后,按照
40、使用次数进行计费无需重新发起订购请求2:免费int4OFee支付金额(以分为单位)int4OEPGGroupNMB产品使用的EPG分组String8O5.9.4 业务订购 接口流程STB增值业务系统业务管理平台a)http请求f)返回处理结果c)业务订购请求b)重定向d)返回业务订购确认页面e)确认订购g)保存订购信息h)返回处理页面图5-9-4-1-1:即时业务订购流程图 接口协议内容承载协议:HTTP GET接口方向:增值业务系统重定向 业务管理平台接口功能:用户订购业务请求消息包含以下关键参数表5-9-4-2-1:业务订购请求参数名称说明数据类型长度(字节)是
41、否必选SPIDSP 的唯一标识String8MUserIDIPTV 用户业务编号String36OContentIDIPTV内容IDstring32OServiceIDIPTV 服务编号String32MProductIDIPTV 产品编号String32MUserToken业务管理平台为该用户分配的临时身份证明,可采用Cookie 的方式传递String32MReturnURL返回EPG 服务页面的URLString256MAction操作类型:1:表示订购;2:表示退订。String20M订购成功或取消订购结束后,业务管理系统重定向返回增值服务系统,通过URL 参数携带以下信息:表5-9-
42、4-2-2:关键信息名称说明数据类型长度(字节)是否必选Result业务订购结果 0:成功 其他:失败String4MDescription结果描述String256OUserIDIPTV用户业务编号string36OUserToken业务管理平台为该用户分配的临时身份证明,可采用Cookie的方式传递string32OContentID内容IDstring32OServiceIDIPTV服务编号string32MProductIDIPTV产品编号string32MProductNameIPTV 产品名称String100OPurchaseType0:包月支付,用户选择订购产品后,按照固定包月
43、费用计费,在当月内无需再次向业务管理平台发起订购请求;1:按次支付,用户选择订购产品后,按照使用次数进行计费无需重新发起订购请求2:免费Int4OFee产品价格,以分为单位Int4MSPIDSP的唯一标识string8OTransactionID订购的事务编号string40OExpiredTime订购关系的失效时间, 格 式 为YYYYMMDDhhmmss。缺少该参数表示永久有效。String14O5.10 业务能力系统数据采集接口5.10.1 采集要求表5-10-1-1 数据采集要求采集周期:每天采集数据形式:以文本文件存放文件命名:以“数据表名称_yyyymmdd.txt”的形式命名日期格式:以“yyyy-mm-dd hh24:mi:ss”的格式输出字段分割:以字符“|”或“,”为分
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 2025年在线教育平台用户增长与留存策略在线教育平台用户增长与留存策略可持续发展
- 运动品牌数字化营销策略优化与用户忠诚度提升报告:2025年分析
- 《虚拟仿真实验课程与教学资源的设计、开发与应用研究》课题第二阶段总结模版
- 智慧农业大数据平台建设与农业金融服务融合研究报告
- 福建省南安市2023-2024学年中考联考数学试题含解析
- 城市新区规划调整2025年对城市居民生活质量风险评估报告
- 交通流量预测在2025年智慧交通系统中的预测精度与效率提升研究报告
- 健康心理学保持身心健康的秘诀
- 智能化标准化厂房建设与设计规划
- 小学生毕业典礼家长代表发言稿
- 关于员工心理健康的重要性
- 刑事案件模拟法庭剧本完整版五篇
- 2022年高考全国I卷数学高考真题(原卷版)
- 《商务英语阅读》教学大纲
- 会计学毕业论文8000字-会计学论文范文8000字
- 小学教育毕业论文6000字范文
- 《爱心树》-经典绘本省名师优质课赛课获奖课件市赛课一等奖课件
- 初级家政服务员培训烹饪篇课件
- 西游记搞笑剧本【五篇】
- 初中物理-第十二章简单机械复习课教学课件设计
- 第七章聚乙烯醇纤维
评论
0/150
提交评论