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

ICS35200CCSL6553云南省市场监督管理局发布DB53/T1172—2023I本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。DB53/T1172《网络视频“明厨亮灶”系统数据接口规范》与DB53/T1171《网络视频“明厨亮灶” 《网络视频“明厨亮灶”系统信息安全规范》、DB53/T1175《网络视频“明厨亮灶”系统运维规范》等共同构成支撑云南省网络视频“明厨亮灶”系统建设的地方标准体系。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由云南省市场监督管理局提出并归口。本文件起草单位：云南省市场监督管理局信息中心、云南省标准化研究院、昆明冶金高等专科学校、中国电信股份有限公司云南分公司、中国移动通信集团云南有限公司、云南云速信息技术有限公司、昆明市盘龙区云才文翰学校、联通华盛通信有限公司云南分公司。本文件主要起草人：李文安、杨亚琦、朱敏、赵忆宁、朱勋程、李宁、翟瑜、赵欣、付琦、邹汉铮、徐芮、朱思维、艾林、靳为为、李文媛、陈福波、李安、林男、石朝松、张寓哲。DB53/T1172—20231网络视频“明厨亮灶”系统数据接口规范本文件规定了网络视频“明厨亮灶”系统数据提供管理规范，包括数据提供方式、接口技术要求、接口参数和接口协议等。本文件适用于网络视频“明厨亮灶”系统通过接口进行的数据提供服务。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T7408数据元和交换格式信息交换日期和时间表示法GB/T18221信息技术程序设计语言、环境与系统软件接口独立于语言的数据类型3术语和定义下列术语和定义适用于本文件。3.1数据接口DataInterface一组用于数据交换的服务，包括服务的功能、位置以及通讯的协议、传输格式和认证方法。3.2接口协议InterfaceProtocol需要进行信息交换的接口间需要遵从的通信方式和要求。其内容包括协议约定、消息头域、消息体内容等，确定通信程序发送消息和接收消息的规则。3.3网络视频“明厨亮灶”NetworkVideoBrightKitchenBrightStove是指餐饮服务提供者采用网络视频的方式，向社会公众展示餐饮服务相关过程的一种形式。4缩略语下列缩略语适用于本文件。HTTPS：安全超文本传输协议（HyperTextTransferProtocoloverSecureSocketLayer）JSON：一种轻量级的数据交换格式(JavaScriptObjectNotation)MD5：消息摘要算法第五版（Message-DigestAlgorithm5）RESTFul：基于HTTPS协议，使用JSON格式定义Token：是服务端生成的一串加密字符串、以作客户端进行请求的一个“令牌”URL：互联网服务程序上用于指定信息位置的表示方法（UniformResourceLocator）UTF-8：一种可变长度字符编码(8-bitUnicodeTransformationFormat)DB53/T1172—202325数据提供方式网络视频“明厨亮灶”系统将以调用接口的方式进行数据提供服务。外部系统在使用数据提供服务前需要向云南省市场监督管理局进行申请，在经过网络视频“明厨亮灶”系统管理员的审批后即可获取调用接口的权限。6接口技术要求6.1接口基本要求接口通过服务调用实现信息交换，应符合下列要求：——采用符合GB/T7408规定的日期类型；——接口请求与接口响应均采用主流数据格式（如JSON、XML等）；——建立接口日志记录，能识别数据异常情况。6.2接口协议6.2.1采用基于HTTPS传输协议的RESTFul接口方式。6.2.2采用主流格式（如JSON、XML等）报文打包方式。6.3基本数据类型接口采用符合GB/T18221规定的数据类型。6.4接口安全要求明厨亮灶数据接口采用数字令牌的方式实现安全认证。使用明厨亮灶数据接口的用户,可以申请系统签发的唯一的数字令牌。使用接口传输数据时附加数字令牌,实现身份识别认证。数字令牌具有一定有效期，令牌失效后用户需要重新申请新的令牌，用户的新令牌一经颁发，原有令牌即刻失效。7数据类型的描述规则数据类型遵循和采用GB/T18221的规定。在本标准中涉及到以下几种数据类型：a)字符型：可以包括字母字符、数字字符或汉字等在内的任意字符；b)数字型：数值；c)日期型：YYYYMMDD。8数据接口8.1接口目录接口目录见表1。表1接口目录12DB53/T1172—20233表1接口目录（续）345678.2基本信息接口8.2.1安全认证接口获取权限token信息，进行安全认证，请求参数见表2。表2安全认证接口请求参数是是申请调用接口的请求秘钥，使用MD5加密是是8.2.2查询餐饮服务提供者接口获取接入“明厨亮灶”系统的餐饮服务提供者详细信息的查询接口，请求参数见表3。表3查询餐饮服务提供者接口请求参数是是查询餐饮服务提供者接口，返回值见表4。表4查询餐饮服务提供者返回值personLiablepersonLiablePhonebusinessLicenseImagelicenceImageentTypesaddressenterpriseCode8.3设备信息接口DB53/T1172—202348.3.1查询企业接入的设备信息，包括设备编号、设备点位信息等，请求参数见表5。表5查询设备信息请求参数enterpriseCode是deviceCode是8.3.2查询设备信息，返回值见表6所示。表6查询设备信息返回值deviceCodeoffLineTimeaccessTime设备在线状态（1在线、2离线）8.4预警抓拍数据接口8.4.1获取视频流地址接口获取视频流地址接口，请求参数参数见表7。表7获取视频流地址请求参数是获取视频流地址，返回值见表8所示。表8获取视频流地址返回值videoUrlType8.4.2查询预警抓拍接口查询餐饮服务提供者预警抓拍图片，请求参数见表9。表9预警抓拍新增数据请求参数是DB53/T1172—20235表9预警抓拍新增数据请求参数（续）字段名称否createTime否cameraLocation否orgName是预警抓拍查询，返回值见表10所示。表10预警抓拍返回值cameraLocationcreateTimemodelscameraIdorgName8.4.3查询预警信息查询餐饮服务提供者预警抓拍图片，请求参数见表11。表11查询预警信息数据请求参数是是createTime是orgName是warningType是预警抓拍查询，返回值见表12所示。表12查询预警信息返回值createTimeorgNamewarningType8.4.4查询网络巡检信息查询餐饮服务提供者网络巡检信息接口，请求参数见表13。DB53/T1172—20236表13查询网络巡检信息请求参数是是orgName是entTypes是是查询餐饮服务提供者网络巡检信息