GY/T 346-2021.Specification of interfaces for user“double authentication and accounting”for both IPTV integrated playout management platform and transmission system.
GY/T 346规定了IPTV集成播控平台与传输系统之间“双认证、双计费”的主要对接流程,定义了用户、认证、计费相关的接口规范。
GY/T 346适用于IPTV集成播控平台和IPTV传输系统采用“双认证、双计费”方式的规划、设计、建设、运行、管理和维护。
2规范性引用文件
GY/T 346没有规范性引用文件。
3术语、定义和缩略语
3.1术语和定义
下列术语和定义适用于本文件。
3.1.1双认证、双计费double authentication and account ingIPTV集成播控平台与IPTV传输系统双方对用户的认证、鉴权、计费。
3.1.2IPTV集成播控平台IPTV integrated playout management platform负责对IPTV业务进行集成播出控制管理。
3.1.3IPTV传输系统IPTV transmiss ion system负责为IPTV集成播控平台与用户端之间提供信号传输分发，为IPTV用户提供有保障的服务。
3.2缩略语
下列缩略语适用于本文件。.
HTTP
超文本传输协议(HyperText Transfer Protocol)
JSON JavaScript对 象表示法(JavaScript Object Notation)
REST
表述性状态传递(Representational State Transfer)
URL统一资源定 位符(Uniform Resource Locator )
4接口概述

中华人民共和国广播电视和网络视听行业标准GY/T346—2021
IPTV集成播控平台与传输系统
用户“双认证、双计费”接口规范　Specification of interfaces for user “double authentication and accounting\ for bothIPTV integrated playout management platform and transmission system2021-02-26发布
国家广播电视总局
2021-02-26实施
-nrKaeerKAca-
1范围
2规范性引用文件
3术语、定义和缩略语
3.1术语和定义
3.2缩略语
4接口概述，
5业务流程描述
5.1开通/销户流程
5.2认证流程
5.3鉴权流程
5.4计费流程
6接口要求
6.1接口交互机制
6.2创建用户接口
6.3修改用户状态接口
6.4用户认证接口
6.5业务鉴权接口
6.6产品订购/退订同步接口
6.7支付结果同步接口
参考文献
-rKaeerKAca-
GY/T346—2021
GY/T3462021
本文件按照GB/T1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。
请注意本文件的某些内容可能涉及专利。本文件发布机构不承担识别这些专利的责任。本文件由全国广播电影电视标准化技术委员会（SAC/TC239）归口。本文件起草单位：国家广播电视总局广播电视科学研究院、爱上电视传媒（北京）有限公司、广西广电新媒体有限公司、中广电广播电影电视设计研究院、国家广播电视总局监管中心、北京广播电视台、广西广播电视台、百视通网络电视技术发展有限责任公司、湖南广播电视台、咪咕文化科技有限公司、中国联合网络通信有限公司网络技术研究院、天翼智慧家庭科技有限公司。本文件主要起草人：尹亚光、张伟、潘红梅、徐磊、孙海波、陈哲、王新喆、赵志成、施玉海、杨凯、李良、张琪、锁强、王慧、李洁、祝谷乔、何晶、赵耀峰、刘万年、万时华、于鼎、张帆。-iiKaeerKAca
GY/T346—2021
IPTV集成播控平台与传输系统用户“双认证、双计费”接口规范1范围
本文件规定了IPTV集成播控平台与传输系统之间“双认证、双计费”的主要对接流程，定义了用户、认证、计费相关的接口规范。
本文件适用于IPTV集成播控平台和IPTV传输系统采用“双认证、双计费”方式的规划、设计、建设、运行、管理和维护。
规范性引用文件
本文件没有规范性引用文件。
3术语、定义和缩略语
3.1术语和定义
下列术语和定义适用于本文件。3.1.1
双认证、双计费doubleauthentication and accountingIPTV集成播控平台与IPTV传输系统双方对用户的认证、鉴权、计费。3.1.2
IPTV集成播控平台IPTVintegratedplayoutmanagementplatform负责对IPTV业务进行集成播出控制管理。3.1.3
IPTV传输系统
IPTVtransmissionsystem
负责为IPTV集成播控平台与用户端之间提供信号传输分发，为IPTV用户提供有保障的服务。3.2缩略语
下列缩略语适用于本文件。
HTTP超文本传输协议（HyperTextTransferProtocol）JSONJavaScript对象表示法（JavaScriptObjectNotation）REST
表述性状态传递（RepresentationalStateTransfer）URL统一资源定位符（UniformResourceLocator）4接口概述
IPTV集成播控平台与IPTV传输系统之间的“双认证、双计费”接口，实现用户信息和用户状态的同步，实现双方同时进行用户认证、实现双方协同进行订购计费的功能。“双认证、双计费”接口示意图见图1。
-rrKaeerKAca-
GY/T3462021
用户信息包括但不限于：用户标识、IPTV用户终端MAC地址、设备编号、归属省份、归属地市等。用户状态包括但不限于：未激活、激活、停机、销户等。用户管理
用户注册
用户管理
5业务流程描述
5.1开通/销户流程
认证、鉴权、计费
计费信息
认证、鉴权、计费
认证信息
鉴权信息
计费信息
用户终端软件
“双认证、双计费”接口示意图IPTV集成播控平台wwW.bzxz.Net
认证信息
鉴权信息
计费信息
IPTV传输系统
IPTV用户终端
用户在IPTV传输系统中开通/销户业务，IPTV传输系统需要向IPTV集成播控平台同步用户及业务信息。用户开通/销户流程图见图2。-rrKaeerKca-
流程说明：
IPTV传输系统
a）用户申请开通/销户
IPTV集成播控平台
b）处理开通/销户申请
c）用户信息同步
e）用户信息同步响应
f）用户开通/销户响应
2用户开通/销户流程图
用户向IPTV传输系统发起开通/销户请求；IPTV传输系统处理用户开通/销户申请：GY/T3462021
d）处理用户信息
IPTV传输系统将用户信息同步到IPTV集成播控平台，接口见6.2，在使用过程中，用户及业务状态发生变化的时候，需要调用接口6.3，修改用户状态；IPTV集成播控平台处理用户信息：IPTV集成播控平台应答用户信息同步结果：IPTV传输系统向用户反馈用户开通/销户成功的信息。5.2认证流程
IPTV用户终端开机时，需要向IPTV集成播控平台进行认证，认证通过后才可以使用IPTV业务。其中，采用双认证双计费方式的IPTV用户终端需要向IPTV集成播控平台和IPTV传输系统进行认证。只有双方认证都通过，才可以使用IPTV业务。IPTV集成播控平台用户管理系统中的用户账户应当与IPTV传输系统用户管理系统中的用户账户实现一一对应。IPTV双认证流程图见图3。
rKaeerKAca-
GY/T3462021
用户终端
流程说明：
a）开机认证请求
c）传输系统认证结果
IPTV传输系统
d）开机认证请求
b）认证处理
f）播控平台认证结果
g）处理认证结果
3IPTV双认证流程图
用户终端向IPTV传输系统发送认证请求，接口见6.4；IPTV传输系统进行认证处理；
IPTV传输系统返回认证结果；
IPTV集成播控平台
用户终端向IPTV集成播控平台发送认证请求，接口见6.4；IPTV集成播控平台进行认证处理：IPTV集成播控平台返回认证结果：e）认证处理
用户终端处理认证结果，两次认证都通过，用户可以使用IPTV业务，否则在用户终端提示认证失败信息。
5.3鉴权流程
在“双认证、双计费”方式下，用户终端播放节目前需要到IPTV集成播控平台进行鉴权或到IPTV集成播控平台及IPTV传输系统进行双鉴权。IPTV业务双鉴权流程图见图4。
-rrKaeerKAca-
用户终端
流程说明：
a）业务鉴权请求
c）业务鉴权结果
IPTV传输系统
d）业务鉴权请求
f）业务鉴权结果
g）处理鉴权结果
IPTV集成播控平台
b）业务鉴权处理
GY/T3462021
e）业务鉴权处理
图4IPTV业务双鉴权流程图
用户终端请求IPTV传输系统进行业务鉴权，接口见6.5IPTV传输系统进行业务鉴权：
IPTV传输系统返回鉴权结果：
用户终端请求IPTV集成播控平台进行业务鉴权，接口见6.5；IPTV集成播控平台进行业务鉴权：IPTV集成播控平台返回鉴权结果：用户终端处理鉴权结果，如果鉴权失败，用户终端上显示订购列表，可以提示用户订购，跳转到计费流程。
5.4计费流程
对于增值付费内容产品，需要先订购才能观看。IPTV增值付费内容产品的订购，由IPTV集成播控平台和IPTV传输系统共同完成。IPTV产品订购/退订双计费流程图见图5。5
-rrKaeerKAca-
GY/T3462021
用户终端
流程说明：
IPTV传输系统
a）发起订购/退订请求
c）同步订单信息
IPTV集成播控平台
b）处理订单
d）订单信息同步响应
e）返回订购/退订响应
f）发起支付/退费请求
>g）支付/退费处理
h）同步支付/退费结果
i）支付/退费结果同步响应
j）返回支付/退费结果
5IPTV产品订购/退订双计费流程图图5
用户在终端上选择订购/退订产品，向IPTV集成播控平台发起订购/退订请求；IPTV集成播控平台收到订购/退订请求后，生成订单信息：IPTV集成播控平台向IPTV传输系统同步订单信息，接口见6.6；IPTV传输系统返回订单信息同步的响应；IPTV集成播控平台向用户终端返回订购/退订响应：用户终端向IPTV集成播控平台发起支付/退费请求：IPTV集成播控平台进行支付/退费处理；IPTV集成播控平台向IPTV传输系统同步支付/退费结果，接口见6.7；IPTV传输系统返回支付/退费结果同步的消息：IPTV集成播控平台向用户终端返回支付/退费结果根据当前业务开展情况，IPTV集成播控平台可通过IPTV传输系统进行支付和退费。其产品订购/退订的双计费流程图见图6。6
rrKaeerKAca
用户终端
流程说明：
IPTV传输系统
a）发起订购/退订请求
c）同步订单信息
IPTV集成播控平台
GY/T3462021
b）处理订单
d）订单信息同步响应
e）返回订购/退订响应
f)发起支付/退费请求
g）支付/退费处理
h)返回支付/退费结果
i)同步支付/退费结果
3)支付/退费结果同步响应
IPTV产品订购/退订流程图
用户在终端上选择订购/退订产品，向IPTV集成播控平台发起订购/退订请求；IPTV集成播控平台收到订购/退订请求后，生成订单信息；IPTV集成播控平台向IPTV传输系统同步订单信息，接口见6.6；IPTV传输系统返回订单信息同步的响应：IPTV集成播控平台向用户终端返回订购/退订响应；用户终端向IPTV传输系统发起支付/退费请求；IPTV传输系统进行支付/退费处理：IPTV传输系统向用户终端返回支付/退费结果：IPTV传输系统向IPTV集成播控平台同步支付/退费结果，接口见6.7：IPTV集成播控平台返回支付/退费结果同步的消息。接口要求
接口交互机制
rrKaerAca
GY/T3462021
用JSON描述和实现，HTTPPOST请求的header参数需要指定Content-Type：接口采用RESTfulAPI，
application/json。
注：RESTfu1是一种网络应用程序的设计风格和开发方式。接口交互流程见图7。
接口请求方
创建用户接口
6.2.1接口描述
a）构造请求数据
b）发送请求数据
e）发送响应请求
接口响应方
c）业务处理
d)构造响应数据
图7接口交互流程图
接口功能：在用户开通的时候，传输系统向集成播控平台同步用户数据和业务数据。接口方向：传输系统至集成播控平台。6.2.2
请求数据
创建用户请求的数据见表1。
UserID
FatherAccount
AccountType
Password
DeviceID
数据类型
String
String
String
String
String
String
是否必选
创建用户请求数据
用户标识
主账号
账号类型
播控平台的唯一标识
设备编号
IPTV用户终端MAC地址，格式为：xx：xx：xx:xx：xx:xx-rKaeerKAca-
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。