1、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 11
2、75网络视频“明厨亮灶”系统运维规范等共同构成支撑云南省网络视频“明厨亮灶”系统建设的地方标准体系。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由云南省市场监督管理局提出并归口。本文件起草单位：云南省市场监督管理局信息中心、云南省标准化研究院、昆明冶金高等专科学校、中国电信股份有限公司云南分公司、中国移动通信集团云南有限公司、云南云速信息技术有限公司、昆明市盘龙区云才文翰学校、联通华盛通信有限公司云南分公司。本文件主要起草人：李文安、杨亚琦、朱敏、赵忆宁、朱勋程、李宁、翟瑜、赵欣、付琦、邹汉铮、徐芮、朱思维、艾林、靳为为、李文媛、陈福波、李安、林男、石朝松、
3、张寓哲。DB53/T 117220231网络视频“明厨亮灶”系统数据接口规范1范围本文件规定了网络视频“明厨亮灶”系统数据提供管理规范，包括数据提供方式、接口技术要求、接口参数和接口协议等。本文件适用于网络视频“明厨亮灶”系统通过接口进行的数据提供服务。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 7408数据元和交换格式信息交换日期和时间表示法GB/T 18221信息技术 程序设计语言、环境与系统软件接口 独立于语言的数据类型3术
4、语和定义下列术语和定义适用于本文件。3.1数据接口 Data Interface一组用于数据交换的服务，包括服务的功能、位置以及通讯的协议、传输格式和认证方法。3.2接口协议 Interface Protocol需要进行信息交换的接口间需要遵从的通信方式和要求。其内容包括协议约定、消息头域、消息体内容等，确定通信程序发送消息和接收消息的规则。3.3网络视频“明厨亮灶”Network Video Bright Kitchen Bright Stove是指餐饮服务提供者采用网络视频的方式，向社会公众展示餐饮服务相关过程的一种形式。4缩略语下列缩略语适用于本文件。HTTPS：安全超文本传输协议（Hy
5、per 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
6、Format)DB53/T 1172202325数据提供方式网络视频“明厨亮灶”系统将以调用接口的方式进行数据提供服务。外部系统在使用数据提供服务前需要向云南省市场监督管理局进行申请，在经过网络视频“明厨亮灶”系统管理员的审批后即可获取调用接口的权限。6接口技术要求6.1接口基本要求接口通过服务调用实现信息交换，应符合下列要求：采用符合 GB/T 7408 规定的日期类型；接口请求与接口响应均采用主流数据格式（如 JSON、XML 等）；建立接口日志记录，能识别数据异常情况。6.2接口协议6.2.1采用基于 HTTPS 传输协议的 RESTFul 接口方式。6.2.2采用主流格式（如 JSON
7、、XML 等）报文打包方式。6.3基本数据类型接口采用符合GB/T 18221规定的数据类型。6.4接口安全要求明厨亮灶数据接口采用数字令牌的方式实现安全认证。使用明厨亮灶数据接口的用户,可以申请系统签发的唯一的数字令牌。使用接口传输数据时附加数字令牌,实现身份识别认证。数字令牌具有一定有效期，令牌失效后用户需要重新申请新的令牌，用户的新令牌一经颁发，原有令牌即刻失效。7数据类型的描述规则数据类型遵循和采用 GB/T 18221 的规定。在本标准中涉及到以下几种数据类型：a)字符型：可以包括字母字符、数字字符或汉字等在内的任意字符；b)数字型：数值；c)日期型：YYYYMMDD。8数据接口8.
8、1接口目录接口目录见表1。表 1接口目录序号接口分类接口名称1基本信息接口安全认证接口2查询餐饮服务提供者接口DB53/T 117220233表 1接口目录（续）序号接口分类接口名称3设备信息接口查询设备信息接口4预警抓拍数据接口获取视频流地址接口5查询预警抓拍接口6查询预警信息7查询网络巡检信息8.2基本信息接口8.2.1安全认证接口获取权限token信息，进行安全认证，请求参数见表2。表 2安全认证接口请求参数参数名称数据类型长度（Byte）是否必填描述appId字符型32是申请调用接口的请求 idpassword字符型45是申请调用接口的请求秘钥，使用 MD5 加密grantType字符
9、型45是授权类型，固定填写：passwordscope字符型255是权限，默认填写：all8.2.2查询餐饮服务提供者接口8.2.2.1获取接入“明厨亮灶”系统的餐饮服务提供者详细信息的查询接口，请求参数见表3。表 3查询餐饮服务提供者接口请求参数参数名称数据类型长度（Byte）是否必填描述enterpriseCode字符型64是统一社会信用代码entName字符型32是餐饮服务提供者名称8.2.2.2查询餐饮服务提供者接口，返回值见表4。表 4查询餐饮服务提供者返回值参数名称数据类型长度（Byte）licenceImag描述entName字符型32餐饮服务提供者名称personLiable字
10、符型64餐饮服务提供者法定代表人personLiablePhone数字型64餐饮服务提供者法定代表人联系电话businessLicenseImage字符型255营业执照图片 URLlicenceNo字符型64食品经营许可证号e字符型255食品经营许可证图片 URLentTypes字符型255餐饮服务提供者类型（学校食堂、政企食堂等）address字符型255餐饮服务提供者经营地址enterpriseCode字符型64统一社会信用代码8.3设备信息接口DB53/T 1172202348.3.1查询企业接入的设备信息，包括设备编号、设备点位信息等，请求参数见表5。表 5查询设备信息请求参数字段名称
11、类型长度（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.
12、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是统一社会信用代码DB53/T
13、117220235表 9预警抓拍新增数据请求参数（续）字段名称类型长度（Byte）是否必填描述entName字符型64否餐饮服务提供者名称createTime日期型16否抓拍时间cameraLocation字符型255否抓拍区域orgName字符型64是监督管理机构8.4.2.2预警抓拍查询，返回值见表10所示。表 10预警抓拍返回值参数名称数据类型长度（Byte）描述entName字符型64餐饮服务提供者名称imageUrl字符型255抓拍图片 URLcameraLocation字符型255抓拍区域createTime日期型16抓拍时间models字符型255抓拍模型cameraId字符型3
14、2摄像头编码orgName字符型64监督管理机构8.4.3查询预警信息8.4.3.1查询餐饮服务提供者预警抓拍图片，请求参数见表11。表 11查询预警信息数据请求参数字段名称类型长度（Byte）是否必填描述enterpriseCode字符型64是统一社会信用代码entName字符型64是餐饮服务提供者名称createTime日期型16是预警日期orgName字符型64是监督管理机构warningType字符型64是预警类型8.4.3.2预警抓拍查询，返回值见表12所示。表 12查询预警信息返回值参数名称数据类型长度（Byte）描述entName字符型64餐饮服务提供者名称enterpriseC
15、ode字符型64统一社会信用代码createTime日期型16预警日期orgName字符型64监督管理机构warningType字符型255预警类型content字符型255预警内容8.4.4查询网络巡检信息8.4.4.1查询餐饮服务提供者网络巡检信息接口，请求参数见表13。DB53/T 117220236表 13查询网络巡检信息请求参数字段名称类型长度（Byte）是否必填描述enterpriseCode字符型64是统一社会信用代码entName字符型64是餐饮服务提供者名称orgName字符型64是监督管理机构entTypes字符型64是餐饮服务提供者类型（学校食堂、政企食堂等）inspec
16、tNum字符型64是巡检编号8.4.4.2查询餐饮服务提供者网络巡检信息，返回值见表14所示。表 14预警信息返回值参数名称数据类型长度（Byte）描述entName字符型64餐饮服务提供者名称enterpriseCode字符型64统一社会信用代码inspectDate日期型16巡检日期orgName字符型64监督管理机构inspectCount字符型32巡检次数noAccordCount字符型32巡检不合格次数inspectTermCount字符型32巡检项数problemTermCount字符型32问题项数investigationRemark字符型255整改意见investigationResult字符型255巡检结果（1 合格 2 不合格）inspectTermContent字符型32巡检内容DB53/T 11722023
