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

ICS35200

CCSL65

53

云南省地方标准

DB53/T1172—2023

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

2023-04-25发布2023-07-25实施

云南省市场监督管理局  发布

DB53/T1172—2023

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

DB53/T1172《网络视频“明厨亮灶”系统数据接口规范》与DB53/T1171《网络视频“明厨亮灶”

系统数据采集技术规范》、DB53/T1173《网络视频“明厨亮灶”在线数据监测及预警规范》、DB53/T1174

《网络视频“明厨亮灶”系统信息安全规范》、DB53/T1175《网络视频“明厨亮灶”系统运维规范》

等共同构成支撑云南省网络视频“明厨亮灶”系统建设的地方标准体系。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由云南省市场监督管理局提出并归口。

本文件起草单位：云南省市场监督管理局信息中心、云南省标准化研究院、昆明冶金高等专科学校、

中国电信股份有限公司云南分公司、中国移动通信集团云南有限公司、云南云速信息技术有限公司、昆

明市盘龙区云才文翰学校、联通华盛通信有限公司云南分公司。

本文件主要起草人：李文安、杨亚琦、朱敏、赵忆宁、朱勋程、李宁、翟瑜、赵欣、付琦、邹汉铮、

徐芮、朱思维、艾林、靳为为、李文媛、陈福波、李安、林男、石朝松、张寓哲。

I

DB53/T1172—2023

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

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)

1

DB53/T1172—2023

5数据提供方式

网络视频“明厨亮灶”系统将以调用接口的方式进行数据提供服务。外部系统在使用数据提供服务

前需要向云南省市场监督管理局进行申请，在经过网络视频“明厨亮灶”系统管理员的审批后即可获取

调用接口的权限。

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查询餐饮服务提供者接口

2

DB53/T1172—2023

表1接口目录（续）

序号接口分类接口名称