ICS35200 CCSL65 53 云南省地方标准 DB53/T1172—2023 网络视频“明厨亮灶”系统数据接口规范 2023-04-25发布 2023-07-25实施 云南省市场监督管理局  发布 DB53/T1172—2023 I前言 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草。 DB53/T1172《网络视频“明厨亮灶”系统数据接口规范》与DB53/T1171《网络视频“明厨亮灶” 系统数据采集技术规范》、DB53/T1173《网络视频“明厨亮灶”在线数据监测及预警规范》、DB53/T1174 《网络视频“明厨亮灶”系统信息安全规范》、DB53/T1175《网络视频“明厨亮灶”系统运维规范》 等共同构成支撑云南省网络视频“明厨亮灶”系统建设的地方标准体系。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由云南省市场监督管理局提出并归口。 本文件起草单位：云南省市场监督管理局信息中心、云南省标准化研究院、昆明冶金高等专科学校、 中国电信股份有限公司云南分公司、中国移动通信集团云南有限公司、云南云速信息技术有限公司、昆 明市盘龙区云才文翰学校、联通华盛通信有限公司云南分公司。 本文件主要起草人：李文安、杨亚琦、朱敏、赵忆宁、朱勋程、李宁、翟瑜、赵欣、付琦、邹汉铮、 徐芮、朱思维、艾林、靳为为、李文媛、陈福波、李安、林男、石朝松、张寓哲。 DB53/T1172—2023 1网络视频“明厨亮灶”系统数据接口规范 1范围 本文件规定了网络视频“明厨亮灶”系统数据提供管理规范，包括数据提供方式、接口技术要求、 接口参数和接口协议等。 本文件适用于网络视频“明厨亮灶”系统通过接口进行的数据提供服务。 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—2023 25数据提供方式 网络视频“明厨亮灶”系统将以调用接口的方式进行数据提供服务。外部系统在使用数据提供服务 前需要向云南省市场监督管理局进行申请，在经过网络视频“明厨亮灶”系统管理员的审批后即可获取 调用接口的权限。 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接口目录 序号 接口分类 接口名称 1 基本信息接口安全认证接口 2 查询餐饮服务提供者接口 DB53/T1172—2023 3表1接口目录（续） 序号 接口分类 接口名称 3 设备信息接口 查询设备信息接口 4 预警抓拍数据接口获取视频流地址接口 5 查询预警抓拍接口 6 查询预警信息 7 查询网络巡检信息 8.2基本信息接口 8.2.1安全认证接口 获取权限token信息，进行安全认证，请求参数见表2。 表2安全认证接口请求参数 参数名称 数据类型 长度（Byte） 是否必填 描述 appId 字符型 32 是 申请调用接口的请求id password 字符型 45 是 申请调用接口的请求秘钥，使用MD5加密 grantType 字符型 45 是 授权类型，固定填写：password scope 字符型 255 是 权限，默认填写：all 8.2.2查询餐饮服务提供者接口 8.2.2.1获取接入“明厨亮灶”系统的餐饮服务提供者详细信息的查询接口，请求参数见表3。 表3查询餐饮服务提供者接口请求参数 参数名称 数据类型 长度（Byte） 是否必填 描述 enterpriseCode 字符型 64 是 统一社会信用代码 entName 字符型 32 是 餐饮服务提供者名称 8.2.2.2查询餐饮服务提供者接口，返回值见表4。 表4查询餐饮服务提供者返回值 参数名称 数据类型 长度（Byte） licenceImag描述 entName 字符型 32 餐饮服务提供者名称 personLiable 字符型 64 餐饮服务提供者法定代表人 personLiablePhone 数字型 64 餐饮服务提供者法定代表人联系电话 businessLicenseImage 字符型 255 营业执照图片URL licenceNo 字符型 64 食品经营许可证号 e 字符型 255 食品经营许可证图片URL entTypes 字符型 255 餐饮服务提供者类型（学校食堂、政企食堂等） address 字符型 255 餐饮服务提供者经营地址 enterpriseCode 字符型 64 统一社会信用代码 8.3设备信息接口 DB53/T1172—2023 48.3.1查询企业接入的设备信息，包括设备编号、设备点位信息等，请求参数见表5。 表5查询设备信息请求参数 字段名称 类型 长度（Byte） 是否必填 描述 enterpriseCode 字符型 64 是 统一社会信用代码 deviceCode 字符型 32 是 设备编号 8.3.2查询设备信息，返回值见表6所示。 表6查询设备信息返回值 参数名称 数据类型 长度（Byte） 描述 entName 字符型 64 餐饮服务提供者名称 deviceCode 字符型 32 设备编号 offLineTime 日期型 16 离线时间 accessTime 日期型 16 接入时间 status 字符型 32 设备在线状态（1在线、2离线） addr 字符型 255 摄像头放置地址，如消毒区、烹饪区 serialnumber 字符型 64 资源编码 8.4预警抓拍数据接口 8.4.1获取视频流地址接口 8.4.1.1获取视频流地址接口，请求参数参数见表7。 表7获取视频流地址请求参数 参数名称 数据类型 长度（Byte） 是否必填 描述 serialnumber 字符型 32 是 摄像头编码 8.4.1.2获取视频流地址，返回值见表8所示。 表8获取视频流地址返回值 参数名称 数据类型 长度（Byte） 描述 videoUrlType 字符型 64 视频流类型（hls、rtsp、rtmp） url 字符型 255 视频流地址 8.4.2查询预警抓拍接口 8.4.2.1查询餐饮服务提供者预警抓拍图片，请求参数见表9。 表9预警抓拍新增数据请求参数 字段名称 类型 长度（Byte）是否必填 描述 enterpriseCode 字符型 64 是 统一社会信用代码