网络视频“明厨亮灶”系统数据接口规范DB53T1172-2023.pdf

ICS 35 200CCS L6553云南省地方标准DB53/T 11722023网络视频“明厨亮灶”系统数据接口规范2023-04-25 发布2023-07-25 实施云南省市场监督管理局发 布DB53/T 11722023I前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。DB53/T 1172 网络视频“明厨亮灶”系统数据接口规范与DB53/T 1171网络视频“明厨亮灶”系统数据采集技术规范、DB53/T 1173 网络视频“明厨亮灶”在线数据监测及预警规范、DB53/T 1174网络视频“明厨亮灶”系统信息安全规范、DB53/T 1175网络视频“明厨亮灶”系统运维规范等共同构成支撑云南省网络视频“明厨亮灶”系统建设的地方标准体系。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由云南省市场监督管理局提出并归口。本文件起草单位：云南省市场监督管理局信息中心、云南省标准化研究院、昆明冶金高等专科学校、中国电信股份有限公司云南分公司、中国移动通信集团云南有限公司、云南云速信息技术有限公司、昆明市盘龙区云才文翰学校、联通华盛通信有限公司云南分公司。本文件主要起草人：李文安、杨亚琦、朱敏、赵忆宁、朱勋程、李宁、翟瑜、赵欣、付琦、邹汉铮、徐芮、朱思维、艾林、靳为为、李文媛、陈福波、李安、林男、石朝松、张寓哲。DB53/T 117220231网络视频“明厨亮灶”系统数据接口规范1范围本文件规定了网络视频“明厨亮灶”系统数据提供管理规范，包括数据提供方式、接口技术要求、接口参数和接口协议等。本文件适用于网络视频“明厨亮灶”系统通过接口进行的数据提供服务。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 7408数据元和交换格式信息交换日期和时间表示法GB/T 18221信息技术 程序设计语言、环境与系统软件接口 独立于语言的数据类型3术语和定义下列术语和定义适用于本文件。3.1数据接口 Data Interface一组用于数据交换的服务，包括服务的功能、位置以及通讯的协议、传输格式和认证方法。3.2接口协议 Interface Protocol需要进行信息交换的接口间需要遵从的通信方式和要求。其内容包括协议约定、消息头域、消息体内容等，确定通信程序发送消息和接收消息的规则。3.3网络视频“明厨亮灶”Network Video Bright Kitchen Bright Stove是指餐饮服务提供者采用网络视频的方式，向社会公众展示餐饮服务相关过程的一种形式。4缩略语下列缩略语适用于本文件。HTTPS：安全超文本传输协议（Hyper Text Transfer Protocol over Secure Socket Layer）JSON：一种轻量级的数据交换格式(JavaScript Object Notation)MD5：消息摘要算法第五版（Message-Digest Algorithm 5）RESTFul：基于HTTPS协议，使用JSON格式定义Token：是服务端生成的一串加密字符串、以作客户端进行请求的一个“令牌”URL：互联网服务程序上用于指定信息位置的表示方法（Uniform Resource Locator）UTF-8：一种可变长度字符编码(8-bit Unicode Transformation Format)DB53/T 1172202325数据提供方式网络视频“明厨亮灶”系统将以调用接口的方式进行数据提供服务。外部系统在使用数据提供服务前需要向云南省市场监督管理局进行申请，在经过网络视频“明厨亮灶”系统管理员的审批后即可获取调用接口的权限。6接口技术要求6.1接口基本要求接口通过服务调用实现信息交换，应符合下列要求：采用符合 GB/T 7408 规定的日期类型；接口请求与接口响应均采用主流数据格式（如 JSON、XML 等）；建立接口日志记录，能识别数据异常情况。6.2接口协议6.2.1采用基于 HTTPS 传输协议的 RESTFul 接口方式。6.2.2采用主流格式（如 JSON、XML 等）报文打包方式。6.3基本数据类型接口采用符合GB/T 18221规定的数据类型。6.4接口安全要求明厨亮灶数据接口采用数字令牌的方式实现安全认证。使用明厨亮灶数据接口的用户,可以申请系统签发的唯一的数字令牌。使用接口传输数据时附加数字令牌,实现身份识别认证。数字令牌具有一定有效期，令牌失效后用户需要重新申请新的令牌，用户的新令牌一经颁发，原有令牌即刻失效。7数据类型的描述规则数据类型