长三角地区食品和食用农产品信息第3部分：数据接口.docx

《长三角地区食品和食用农产品信息第3部分：数据接口.docx》由会员分享，可在线阅读，更多相关《长三角地区食品和食用农产品信息第3部分：数据接口.docx（15页珍藏版）》请在优知文库上搜索。

1、ICS35.240.99CCSL78B长江三角洲区域地方标准DB31T310XX.3202XxDB33T310XX.3202XxDB32T310XX.3202XDB34T310XX.3202X长三角地区食品和食用农产品信息追溯第3部分：数据接口YangtzeRiverDeltainformationtraceabilityforfoodandedibleagriculturalproducts一Part3:Datainterface（征求意见稿）在提交反馈意见时，请将您知道的相关专利连同支持性文件一并附上。XXXX-XX-XX发布XXXX-XX-XX实施上海市市场监督管理局、江苏省市场监督管理

2、局浙江省市场监督管理局、安徽省市场监督管理局发布目次前言II引言TTI1范围12规范性引用文件13术语和定义14缩略语25数据共享方式26数据接口技术要求27数据结构38接口安全4附录A（资料性）长三角食品安全信息平台追溯数据接口JSoN格式数据示例6本文件按照GB1.1-2020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。本文件为DB31“310XX长三角地区食品和食用农产品信息追溯的第3部分。DB31/T31OXX已经发布了以下部分：第1部分：通则；第2部分：数据元；第3部分：数据接口。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由上海

3、市市场监督管理局、江苏省市场监督管理局、浙江省市场监督管理局、安徽省市场监督管理局联合提出并归口。本文件主要起草单位：上海市市场监督管理局、上海仪电溯源科技有限公司、上海市质量和标准化研究院、上海海关动植物与食品检验检疫技术中心、江苏省市场监督管理局、江苏省质量和标准化研究院、浙江省市场监督管理局、浙江省标准化研究院、浙江省市场监督管理数字传媒中心、阿里云计算有限公司、安徽省市场监督管理局、安徽省质量和标准化研究院。本文件主要起草人：陈艳、徐振、彭海涛、齐相峰、蔡丽华、邵逸超、石念、朱婕、那品、郭德华、杨捷琳、朱殊瑶、陈志明、卜奎昊、于全才、管旭琳、章学周、侯月丽、杨博、任永斌、金技、阮丽芳、

4、骆琳、郭锐、闻天、丁炜、过李辉、柳凌、李博、安金林、陈寿赛、胡传鑫、程禹、鲁轮、周超群。为全面贯彻“实施食品安全战略，让人民吃得放心”的要求和习近平总书记关于加强食品安全“四个最严的一系列重要指示精神，落实长三角区域一体化发展国家战略，加强农产品质量安全追溯体系建设。上海市、江苏省、浙江省、安徽省食品（药品）安全委员会办公室共同协商签订了长三角地区食品安全信息追溯体系建设战略合作协议，坚持“以人民为中心”的发展思想，贯彻实施食品安全战略,进一步深化食品安全合作协调机制，推进建设“信息互通、监管互动、抽检互认、执法互助的大食品安全工作格局。长三角地区充分利用现代科技手段，在全国率先构建区域联动的

5、食品安全信息追溯体系,推动和促进长三角区域食品安全智能化治理水平提升，保障人民群众“舌尖上的安全DB31/T31OXX拟由三个部分构成。 第1部分：通则，目的在于确立适用于长三角地区食品和食用农产品信息追溯通用技术要求和相关原则。 第2部分：数据元，目的在于规定长三角地区食品和食用农产品追溯信息数据的数据元和数据元目录等。 第3部分：数据接口，目的在于确定适用于长三角地区食品和食用农产品追溯的数据共享方式、数据接口技术要求以及数据接口安全认证方法等内容。数据接口的标准化是长三角地区食品和食用农产品信息追溯数据共享的前提。本文件结合长三角地区食品安全信息追溯体系建设工作实际，旨在确立食品和食用农

6、产品信息追溯系统中各个参与方在数据收集、存储、传递和共享过程中遵循相同的数据接口标准，确保数据的互操作性、一致性和安全性，实现数据的有效共享和合作，更好地保障食品和食用农产品的安全和质量。长三角地区食品和食用农产品信息追溯第3部分：数据接口1范围本文件规定了长三角地区食品和食用农产品追溯的数据共享方式、数据接口技术要求、数据结构和接口安全要求等内容。本文件适用于长三角地区(上海市、江苏省、浙江省、安徽省)内食品和食用农产品追溯信息交换、共享、传输和认证的接口实现。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注口期的引用文件,仅该日期对应的版本适用于本文

7、件；不注口期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GBa7408-2005数据元和交换格式信息交换口期和时间表示法GBfT38155重要产品追溯追溯术语DB31/T310XX.1长三角地区食品和食用农产品信息追溯第1部分：通则DB31/T310XX.2长三角地区食品和食用农产品信息追溯第2部分：数据元IETFRFC1945超文本传输协议Lo(HyPerteXttranSferPrOtOeoI-HTTP/1.0)IETFRFC2616超文本传输协议Ll(HyPerteXttransferprotocol-HTTP/1.1)IETFRFC2818TLS上的HTTP(HTTPove

8、rTLS)IETFRFC3548Basel6BaSe32、Base64数据编码(TheBase16,Base32,andBase64DataEncodings)IETFRFC3629UTF-8,UTF-8,ISOlo646转换格式(UTF-8,aIransformalionformatofISO10646)IETFRFC4627JSON格式定义(Theapplication/JSONmediatypeforjavascriptObjectnotation)3术语和定义GBfT38155、DB31f310XX.l界定的以及下列术语和定义适用于本文件。3.1数据接口datainterface用于数

9、据交换的服务，包括服务的功能、位置以及通讯的协议、传输格式和认证方法。3.2数据接口协议datainterfaceprotocol用来和数据接口服务进行通讯的应用层协议，包括定义消息的内容、消息类型的语法结构、域所包含的信息的含义，确定通信程序何时发送消息和接收消息的规则。3.3接口传输规范interfacetransmissionstandard定义数据源和数据宿之间传送的数据内容的格式和标记语言。3.4安全认证securitycertificate保证数据传输安全的加密方法和身份认证方法。3.5数字令牌digitaltoken分发给传输方，代表传输方身份及权限的加密字符串。3.6“名称/值

10、”对name/valuepairJSON的数据存储格式，“名称/值”对组合中的名称写在前面双引号中，值写在后面双引号中，中间用冒号隔开，“名称/值”对之间由逗号分隔。4缩略语下列缩略语适用于本文件。CA：数字证书认证机构(CertifiCateAUthority)HTTPS：安全超文本传输协议(HyperTextTransferProtocoloverSecureSocketLayer)JSON：一种轻量级的数据交换格式(JavascriptObjectNotation)TLS：传输层安全协议(TranSPortLayerSeCUrity)URL：统一资源定位符(UnifOrmReSOUrCe

11、LoCatOr)UTF-8：一种可变长度字符编码(8-bitUnicodeTransformationFormat)5数据共享方式5.1 长三角地区食品和食用农产品信息追溯，采用各省/直辖市提供统一数据接口服务的共享方式，各省/直辖市按实际情况提供信息的共享接口，供其他省/直辖市的系统使用。5.2 各省/直辖市在需要其他省/直辖市的相关信息追溯时，可以调用对应省/直辖市的数据接口服务，获取追溯数据，用于各自的功能需要。6数据接口技术要求6.1 基本要求长三角地区食品和食用农产品信息追溯数据接口通过服务调用获取所需的信息，应符合下列要求：a)采用符合IETFRFC2818的HTTPS协议作为底层

12、承载协议；b)采用符合IETFRFC3629规定的UTF-8字符集；c)采用符合GB/T7408规定的日期类型；d)采用符合IETFRFC3548规定的Base64编码规则将图片、文件二进制字节流转换为字符串；e)接口响应采用RFC4627规定的JSoN数据格式；f)建立接口日志记录，能识别数据异常或追溯交换数据情况；g)发生错误时，接口将详细的错误代码和错误信息返回给接口使用方，以利于接口使用方进行记录分析和整改。6.2 接口格式定义数据接口格式定义主要包括：a)接口地址：请求的URL地址，一般由域名或IP、端口号、接口路径组成，参见附录A中A.1；b) c)d)e)功能说明 参数说明 请求

13、示例 返回示例数据接口功能的简要描述，参见附录A中A.2；调用数据接口的输入参数或者输出参数情况，参见附录A中A3；数据接口的请求参数示例，参见附录A中A.4；数据接口调用正常或异常的报文主体示例，参见附录A中A.5；f）接口响应码说明：数据接口的响应状态码，参见附录A中A.6。6.3 数据类型数据接口应支持的数据类型包括：a）字符型，用String表示；b）整数型，用Integer表示；c）浮点型，用Float表示；d）布尔型，用BOOIean表示；e）日期时间型，用DateTime表示，应符合GBZT7408-2005中定义的扩展时间表示法。日期格式为：YYYY-MM-DD,时区为中国北京

14、时间（GMT+8）；时间格式为：YYYY-MM-DDThhimnrss,时区为中国北京时间（GMT+8）；根据信息交换中各方的约定，在不会引起日期和时间组合的日的表示法与本标准定义的其他表示法出现混淆的情况下，字符T可以省略；f）文件型，用字符串标识，应采用data:mediatype；base64,data的字符串格式进行拼接。其中：mediatype表示文件的类型，例如application/pdf；data表示文件二进制字节流的Base64编码字符串；g）对象型，用ObjeCt表示，对应JSoN中的“对象符号”；h）数组型，用AITay表示，是一个或多个JSON对象符号的集合；i）空，用

15、NULL表示。7数据结构7.1 追溯数据的总体数据结构7.2 应对接口交换的长三角食品安全信息追溯平台追溯数据的数据集进行封装，追溯数据的数据集由多条追溯数据构成，每一条追溯数据由追溯参与方和追溯单元构成，总体数据结构见图1：图中实线表示必须包含，虚线表示可以包含。线段上的数字表示可以包含的数量，例如：1表示可以包含1条，0.oo:表示可以包含0到多条数据。图1总体数据结构总体数据结构组成元素见表1。表1总体数据结构组成元素名称数据类型是否必填描述追溯数据的数据集Array是追溯数据的数据集数组，由一组或多组追溯数据组成追溯数据Object是追溯数据对象，包括组追溯参与方和组追溯单元信息组成，并可根据需求扩展使用其他信息追溯参与方Object是追溯参与方信息数据包括一组食品和食用农产品生产经营者信息对象（以参数名称enterprise标识）,信息的内容应符合DB31310XX2的要求追溯单元Object是追溯单元数据包括