(电信标准)iptv内容运营平台与业务运营平台接口技术规范

(电信标准)iptv内容运营平台与业务运营平台接口技术规范内容摘要：

化、制作和管理模块 与省级业务运营平台之间的接口，主要完成 直播内容 和 点播内容的 传送 、 直播内容和点播内容相关 EPG 元数据信息的 管理 等功能。 省级 COP 省级 SOP 1） 内容管理请求（ ContentMngReq） 内容管理响应（ ContentMngReqResponse） 3） 内容管理结果（ ContentMngResult） 内容管理结果响应（ ContentMngResultResponse） 3） 执行管理操作 2） 获取 XML 文件 省级内容运营平台 省级 内容运营平 台（ COP） 省 级业 务 运 营平台（ SOP） 省级业务运营平台 C2 IPTV 内容运营平台与业务运营平台接口技术规范 14 本 接口采用 SOAP 协议 +XML 指令文档的方式。 其中 ， SOAP 消息是与具体指令内容无关的通用消息，仅仅用于表达命令请求。 而具体的命令及参数利用独立的 XML文件 来描述。 采用与具体指令无关的通用 SOAP 消息有利于指令扩展及在异步环境中实现通用的可靠消息传递机制。 1） 内容管理请求（ ContentMngReq） 承载协议： SOAP 接口方向： 省级 COP － 省级 SOP 调用接口 ： ContentMngReq response ContentMngReq 接口功能 ： 点播内容、直播内容、 EPG 元数据的下发及管理。 其中 ContentMngRequest 包含如下信息 ： 名称 说明 数据类型 长度（字节） 是否必选 COPID 省级内容运营平台标识 String 8 M SOPID 省级业务运营平台标识 String 8 M CorrelateID 关联性标识 ，用于关联指令执行请求消息和结果通知消息。 对于重发的指令，该字段值保持一致，对于不同的指令，该字段在一个内容运营平台内具有唯一性。 String 20 M ContentMngXMLURL 存放 内容管理 的 XML文件URL String 1024 M 内容管理响应（ ContentMngReqResponse） 其中 ContentMngReqResponse 包含： 名称 说明 数据类型 长度（字节） 是否必选 ResultCode 处理结果 详见附件 A“处理结果（ ResultCode）错误代码表” Int 4 M IPTV 内容运营平台与业务运营平台接口技术规范 15 ErrorDescription 对错误 /异常的详细描述信息 String 256 O 2）管理 文件获取 接口方向：省级 COP － 省级 SOP 调用接口：无 接口功能： SOP 通过 FTP 方式 获 取 存放管理信息的 XML 文件 3） 内容管理结果（ ContentMngResult） 承载协议： SOAP 接口方向： 省级 COP － 省级 SOP 调用接口： ContentMngResult response ContentMngResult 接口功能： SOP 完成管理操作后，通知 COP 操作结果。 说明：本接口支持通过指令方式和文件方式两种方式返回操作结果。 指令方式指通过指令中的字段信息表示操作结果，文件 方式指通过 XML 文件返回操作结果。 其中 ContentMngResult 包含： 名称 说明 数据类型 长度（字节） 是否必选 COPID 内容运营平台标识 String 8 M SOPID 业务运营平台标识 String 8 M CorrelateID 关联性标识，用于关联指令执行请求消息和结果通知消息 String 20 M ResultCode 处理结果： 0：成功 1：失败 Int 4 O ErrorDescription 对错误 /异常的详细描述信息 String 256 O ResultFileURL 应答 XML文件的 URL String 1024 O IPTV 内容运营平台与业务运营平台接口技术规范 16 备注说明： 本接口中， CorrelateID值应该与 ContentMngReq消息中包含的 CorrelateID相等，以标识是对该消息的执行结果反馈。 本接口中 ， ResultCode和 ResultFileURL两者有且只有一项出现。 内容管理结果响应（ ContentMngResultResponse） 其中 ContentMngResultResponse 包含： 名称 说明 数据类型 长度（字节） 是否必选 ResultCode 处理结果 详见附件 A“处理结果（ ResultCode）错误代码表” int 4 M ErrorDescription 对错误 /异常的详细描述信息 String 256 O IPTV 内容运营平台与业务运营平台接口技术规范 17 C3 接口 （ 运营 数据 接口） C3 接口指省级 COP 内容运营管理模块 和省级 SOP 业务管理平台之间的接口，主要完成用户数据同步、 定购 数据同步、 收拾 数据同步等功能。 要求 文件采用 ASCII 文本格式，文件体中每条记录的属性值按顺序排列，各属性间使用分隔符（默认为‘，’，建议可 配置）分隔，在生成文件时若相应的属性值为空， 则用大写字符串“ NULL”表示。 文件中一行作为一条记录，各条记录之间用“回车，换行符”作为分隔并在文件中连续书写。 当 文件中的 某字段不足规定长度时，采用左对齐的 方式， 不需要补足规定长度。 文件 生成 周期及 生成 时间 应可以 根据文件类型分别 设置 ， 缺省设置 文件 生成周期为一天一次， 文件 生成 时间 为 每天凌晨 1 点。 要求 文件命名规则： .日期 .序列号 .txt C3 省级 内容 运营平台 （ COP） 省级业务 运营平台 （ SOP） 业务管理平台 用户数据 、定购数据、收视数据等 内容运营 管理模块 IPTV 内容运营平台与业务运营平台接口技术规范 18 文件类型定义： Userinfo：表示用户信息 的数据 同步 Orderinfo：表示 用户 定购 信息 的数据 同步 Viewinfo：表示用户收视信息的数据同步 日期表示生成该文件的时间，其格式为：年年年年月月日日时时分分秒秒，如 20200703202000 表示文件生成时间为 2020 年 7 月 3 日 20 时 12 分 00 秒。 序列号： 0000~9999，由 0000 开始顺序增 1 不同的文件类型，其 文 件内容格式也不同，分别定义如下。 数据 名称 说明 数据类型 长度（字节） 是否必选 UserId 用户标志 String 36 M usergroup 用户组： 00：测试用户 01：普通用户 02：集团用 户 String 64 M EPGgroup EPG分组编号 String 32 M UserName 用户姓名 String 64 M STBID 机顶盒 ID String 32 O IDNumber 身份证号 /护照号 /社保号 String 18 O Phone 联系电话 String 32 O Sex 用户性别 String 1 O Address 用户地址 String 256 O PostalCode 邮编 String 16 O Email 电子邮件 String 64 O Areacode 区局 String 5 M Services 用户订购的服务列表，用半角逗号分割 String 1024 M Packages 产品包对应的 Package集合（ Code）用半角逗号 分割 String 2048 O timestamp 时间戳，从 1970年 1月 1日 0时开始的毫秒数 String =18 M 信息 数据 名称 说明 数据类型 长度（字节） 是否必选 IPTV 内容运营平台与业务运营平台接口技术规范 19 UserId 用户标志 String 36 M SubscribeTime 订购时间（格式 YYYYMMDD HHMMSS） String 14 M ContentCode 内容 的唯一标识 String 256 M ContentName 内容 名称 String 256 M OrderType 消费类型 ： 单次订购 包时段订购 Int 2 M ServiceID 订购所属的 业务 标识 String 32 M Fee 费用（分） Int 12 M ValideTime 订购 生效 时间（格式 YYYYMMDD HHMMSS） String 14 M ExpiredTime 订购 结束时间（格式 YYYYMMDD HHMMSS） String 14 M VisitPath 用户点播时候的节目内容在展示栏目上的路径，每个栏目使用 Code来标识，例如： /Movie/Action/China: 表示点播的节目为电影栏目下的，动作片子栏目下的中国栏目下 String 128 M SequenceID 本次消费产生的唯一序列号，和收视日志中的唯一序列号是相匹配 String 64 M 名称 说明 数据类型 长度（字节） 是否必选 UserId 用户标志 String 36 M BeginTime 起始时间（ 格式 YYYYMMDD HHMMSS） String 14 M EndTime 结束时间（格式 YYYYMMDD HHMMSS） String 14 M ServiceType 服务类型 1： VOD（点播节目） 2： TV 3： PVR 4： TVOD 5：时移 6： … Int 2 M ContentCode 内容 的唯一标识 String 256 M ContentName 内容 名称 String 256 M IPTV 内容运营平台与业务运营平台接口技术规范 20 SequenceID 收视记录唯一序列号，和消费日志中的唯一序列号是相匹配 String 64 M ShiftDuration 时移的时间（单位为秒）， TVOD有效 Int 12 O Flux 总流量 (KB) Int 12 M EndReason 流媒体服务中断原因 0:正常挂断（ VOD节目结束） 1:用户中断 2:Server内部错误 3:和 Client网络中断 4:计费时间到 5:计费流量到 Int 2 M Product 该服务所属产品标识 String 20 O ChargeType 计费类型 0：免费 1：包时段订购（本次不收费，包月，24小时） 2：按时长计费 3：按流量计费 Int 12 O SumFee 费用（分） Int 12 O Qos 服务过程中平均质量，范围 (1100)， 100最高质量 Int 12 O 名称 说明 数据类型 长度（字节） 是否必选 ContentCode 内容 的唯一标识 String 256 M ContentName 内容 名称 String 256 M ContentState 内容当前所处状态 0：内容上线 1：内容下线 2：内容删除 Int 4 M 接口协议 ： FTP 文件 采集点 ： syncdata 目录 文件 备份目录 ： syncdatabackup 目录 IPTV 内容运营平台与业务运营平台接口技术规范 21 为了便于 COP 的采集， SOP 应建立多级子目录 ，对要传送的文件进行管理。 文件实际 保存 在 “ backup” 目录中，存放在 “ syncdata” 目录中的是指向 “ backup”目录同名文件的符号连接。 采集方式： COP 通过 FTP 连接 到采集点（ syncdata 目录），拷贝后删除，如果有问题，应能从 备份目录 中获取同名的文件；备份目录的维护应该由 SOP负责；至少保留七天，定期自动删除， COP 对备份目录只有 “ 读 ” 权限。 Userinfo COPID 根目录 syncdata Syncdatabackup Orderinfo Userinfo COPID Orderinfo Viewinfo。