![点击分享此内容可以赚币 分享](/master/images/share_but.png)
DB31∕T 310024.3-2024 长三角地区食品和食用农产品信息追溯 第3部分:数据接口(上海市).pdf
《DB31∕T 310024.3-2024 长三角地区食品和食用农产品信息追溯 第3部分:数据接口(上海市).pdf》由会员分享,可在线阅读,更多相关《DB31∕T 310024.3-2024 长三角地区食品和食用农产品信息追溯 第3部分:数据接口(上海市).pdf(17页珍藏版)》请在咨信网上搜索。
1、 ICS 35.240.99 CCS L 78 长江三角洲区域地方标准 长三角地区食品和食用农产品信息追溯 第 3 部分:数据接口 Yangtze River Delta information traceability for food and edible agricultural productsPart 3:Data interface 2024-05-17 发布 2024-09-01 实施 上海市市场监督管理局 江苏省市场监督管理局 浙江省市场监督管理局 安徽省市场监督管理局 DB31/T 310024.32024 DB32/T 310024.32024 DB33/T 310024.
2、32024 DB34/T 310024.32024 发 布 DB31/T 310024.32024 DB32/T 310024.32024 DB33/T 310024.32024 DB34/T 310024.32024 I 目次 前言.II 引言.III 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.1 5 数据接口技术要求.2 6 数据结构.3 7 服务功能类型.4 8 接口安全.4 附录 A(资料性)长三角食品安全信息追溯平台数据接口 JSON 格式数据示例.5 DB31/T 310024.32024 DB32/T 310024.32024 DB33/T 31002
3、4.32024 DB34/T 310024.32024 II 前言 本文件按照GB/T 1.12020标准化工作导则 第 1 部分:标准化文件的结构和起草规则的规定起草。本文件为 DB31/T 310024长三角地区食品和食用农产品信息追溯的第 3 部分。DB31/T 310024已经发布了以下部分:第 1 部分:通则;第 2 部分:数据元;第 3 部分:数据接口。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由上海市市场监督管理局、江苏省市场监督管理局、浙江省市场监督管理局、安徽省市场监督管理局联合提出、归口并组织实施。本文件主要起草单位:上海仪电溯源科技有
4、限公司、上海市质量和标准化研究院、上海市农业科学院、上海海关动植物与食品检验检疫技术中心、江苏省质量和标准化研究院、浙江省标准化研究院、浙江省市场监督管理数字传媒中心、阿里云计算有限公司、安徽省质量和标准化研究院。本文件主要起草人:柳凌、胡传鑫、邵逸超、陈艳、阮丽芳、朱殊瑶、陈志明、潘明阳、崔诚、卜奎昊、陈青宇、管旭琳、章学周、侯月丽、杨博、程禹、鲁轮、周超群、徐振、彭海涛、王献礼、齐相峰、蔡丽华、石念、朱婕、那晶、过李辉、程璐璐、李博、闻天、丁炜、郭锐、钱文婧、骆琳、安金林、陈寿赛、叶文倩、郭德华、杨捷琳。DB31/T 310024.32024 DB32/T 310024.32024 DB3
5、3/T 310024.32024 DB34/T 310024.32024 III 引言 本文件旨在推动构建区域联动的食品安全信息追溯体系。DB31/T 310024 由三个部分构成。第 1 部分:通则。目的在于为长三角地区食品和食用农产品信息追溯平台建设工作提供指导。第 2 部分:数据元。目的在于用来准确无歧义定义长三角地区食品和食用农产品的数据元分类方式和相关数据元信息。第 3 部分:数据接口。目的在于为长三角地区食品和食用农产品信息追溯平台数据接口的设计、开发和应用提供指导。本文件系统梳理了长三角地区食品和食用农产品信息追溯平台中各个参与方在数据收集、存储、传递和共享过程,研究编制了长三角
6、地区食品和食用农产品信息追溯平台数据接口的数据结构和数据接口输出文件,确保数据的互操作性、一致性和安全性。DB31/T 310024.32024 DB32/T 310024.32024 DB33/T 310024.32024 DB34/T 310024.32024 1 长三角地区食品和食用农产品信息追溯 第 3 部分:数据接口 1 范围 本文件规定了长三角地区食品和食用农产品追溯的数据接口技术要求、数据结构、服务功能类型和接口安全要求。本文件适用于长三角地区(上海市、江苏省、浙江省、安徽省)食品和食用农产品追溯信息交换、共享、传输和认证的接口实现。2 规范性引用文件 下列文件中的内容通过文中的
7、规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 74082005 数据元和交换格式 信息交换 日期和时间表示法 GB/T 38155 重要产品追溯 追溯术语 DB31/T 310024.1 长三角地区食品和食用农产品信息追溯 第1部分:通则 DB31/T 310024.2 长三角地区食品和食用农产品信息追溯 第2部分:数据元 IETF RFC 2818 TLS上的HTTP(HTTP over TLS)IETF RFC 3548 Base16、Base32、Base64数据编码
8、(The Base16,Base32,and Base64 Data Encodings)IETF RFC 3629 UTF-8,ISO 10646转换格式(UTF-8,a transformation format of ISO 10646)IETF RFC 4627 JSON格式定义(The application/JSON Media Type for JavaScript Object Notation)3 术语和定义 GB/T 38155、DB31/T 310024.1界定的以及下列术语和定义适用于本文件。3.1 数据接口 data interface 用于数据交换的服务,包括服务的
9、功能、位置以及通讯的协议、传输格式和认证方法。3.2 安全认证 security certificate 保证数据传输安全的加密方法和身份认证方法。3.3 数字令牌 digital token 分发给传输方,代表传输方身份及权限的加密字符串。4 缩略语 DB31/T 310024.32024 DB32/T 310024.32024 DB33/T 310024.32024 DB34/T 310024.32024 2 下列缩略语适用于本文件。CA:数字证书认证机构(Certificate Authority)HTTPS:超文本传输安全协议(HyperText Transfer Protocol o
10、ver Secure Socket Layer)JSON:JavaScript 对象标记(Java ScriptObject Notation)TLS:传输层安全协议(Transport Layer Security)URL:统一资源定位符(Uniform Resource Locator)UTF-8:一种可变长度字符编码(8-bit Unicode Transformation Format)5 数据接口技术要求 5.1 基本要求 长三角地区食品和食用农产品信息追溯数据接口通过服务调用获取所需的信息,应符合下列要求:a)采用符合 IETF RFC 2818 的 HTTPS 协议作为底层承载协
11、议;b)采用符合 IETF RFC 3629 规定的 UTF-8 字符集;c)采用符合 GB/T 7408 规定的日期类型;d)采用符合 IETF RFC 3548 规定的 Base64 编码规则将图片、文件二进制字节流转换为字符串;e)接口响应采用 IETF RFC 4627 规定的 JSON 数据格式;f)建立接口日志记录,能识别数据异常或追溯交换数据情况;g)发生错误时,接口将详细的错误代码和错误信息返回给接口使用方,以利于接口使用方进行记录分析和整改。5.2 接口格式定义 数据接口格式定义主要包括:a)接口地址:请求的 URL 地址,一般由域名或 IP、端口号、接口路径组成,参见附录
12、A 中 A.1;b)功能说明:数据接口功能的简要描述,参见附录 A 中 A.2;c)参数说明:调用数据接口的输入参数或者输出参数情况,参见附录 A 中 A.3;d)请求示例:数据接口的请求参数示例,参见附录 A 中 A.4;e)返回示例:数据接口调用正常或异常的报文主体示例,参见附录 A 中 A.5;f)接口响应码说明:数据接口的响应状态码,参见附录 A 中 A.6。5.3 数据类型 数据接口应支持的数据类型包括:a)字符型,用 String 表示;b)整数型,用 Integer 表示;c)浮点型,用 Float 表示;d)布尔型,用 Boolean 表示;e)日期时间型,用 DateTime
13、 表示,应符合 GB/T 7408-2005 中定义的扩展时间表示法。日期格式为:YYYY-MM-DD,时区为中国北京时间(GMT+8);时间格式为:YYYY-MM-DDThh:mm:ss,时区为中国北京时间(GMT+8);根据信息交换中各方的约定,在不会引起日期和时间组合的日的表示法与本文件定义的其他表示法出现混淆的情况下,字符T可以省略;DB31/T 310024.32024 DB32/T 310024.32024 DB33/T 310024.32024 DB34/T 310024.32024 3 f)文件型,用字符串标识,应采用 data:;base64,的字符串格式进行拼接。其中:表示
14、文件的类型,例如 application/pdf;表示文件二进制字节流的 Base64 编码字符串;g)对象型,用 Object 表示,对应 JSON 中的“对象符号”;h)数组型,用 Array 表示,是一个或多个 JSON 对象符号的集合;i)空,用 NULL 表示。6 数据结构 6.1 应对接口交换的长三角食品安全信息追溯平台追溯数据的数据集进行封装,追溯数据的数据集由多条追溯数据构成,每一条追溯数据由追溯参与方和追溯单元构成,总体数据结构见图 1。注:图中实线表示必须包含,虚线表示可以包含。线段上的数字表示可以包含的数量,例如:1 表示可以包含1条,0.n 表示可以包含0到多条数据。图
15、1 总体数据结构 6.2 总体数据结构组成元素见表 1。表1 总体数据结构组成元素 名称 数据类型 是否必填 描述 追溯数据的数据集 Array 是 追溯数据的数据集数组,由一组或多组追溯数据组成 追溯数据 Object 是 追溯数据对象,包括一组追溯参与方和一组追溯单元信息组成,并可根据需求扩展使用其他信息 追溯参与方 Object 是 追溯参与方信息数据包括一组食品和食用农产品生产经营者信息对象(以参数名称 enterprise 标识),信息的内容应符合DB31/T 310024.2 的要求 DB31/T 310024.32024 DB32/T 310024.32024 DB33/T 31
16、0024.32024 DB34/T 310024.32024 4 表 1 总体数据结构组成元素(续)名称 数据类型 是否必填 描述 追溯单元 Object 是 追溯单元数据包括一组食品和食用农产品基础信息(以参数名称product 标识)、一组食品和食用农产品生产信息(以参数名称production 标识)、一组或多组食品和食用农产品流通信息(以参数名称 circulation 标识)、零或多组食品和食用农产品抽检信息对象(以参数名称 inspection 标识),信息的内容应符合 DB31/T 310024.2 的要求 其他信息 Object 是 视需求,可适情扩展使用,以参数名称 othe
17、r 标识 7 服务功能类型 数据接口服务功能类型主要包括:a)认证接口,用于进行身份认证和授权访问,可以确保安全性和数据隐私;b)查询接口,用于获取数据和信息,可以满足不同的查询需求;c)权限管理接口,用于管理用户和角色的权限,控制对数据的访问和操作。8 接口安全 8.1 安全认证 数据接口采用数字令牌签名的方式进行安全认证。8.2 数字令牌 数据接口调用者应向数据接口服务提供方申请数字令牌,数字令牌通常包含appKey和appSecret两部份,appKey是调用者身份的标识,appSecret是调用者的密钥,调用者使用appSecret以约定的算法对参数数据进行签名。数据接口服务提供方可以
18、通过验证参数数据的签名的方式,识别调用者的身份。8.3 传输安全 数据接口服务方提供基于CA颁发的数字证书和基于TLS之上的HTTPS协议的数据接口服务,应符合IETF RFC 2818中的规范建立连接并传输数据。8.4 数据加密 长三角地区食品和食用农产品信息追溯数据宜通过约定的加密算法,对明文数据进行加密处理后,再进行数据传输。DB31/T 310024.32024 DB32/T 310024.32024 DB33/T 310024.32024 DB34/T 310024.32024 5 附录A (资料性)长三角食品安全信息追溯平台数据接口 JSON 格式数据示例 A.1 接口地址 接口地
19、址通常由请求的URL地址构成,具体包含以下几个部分:域名或IP地址、端口号以及接口路径。示例:https:/域名:端口/api/trace A.2 功能说明 追溯信息查询的服务接口。根据请求调用返回某个追溯码对应的追溯信息。A.3 参数说明 A.3.1 提交方法(Method):接收(Get)。A.3.2 请求头(Header):如表A.1所示。表A.1 请求头(Header)表 参数名称 数据类型 是否必填 描述 appKey String 是 服务端提供给调用者的凭证,用于标识服务接口调用者的身份 timestamp DateTime 是 接口调用时间,采用 YYYY-MM-DDThh:m
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB31T 310024.3-2024 长三角地区食品和食用农产品信息追溯第3部分:数据接口上海市 DB31 310024.3 2024 长三角 地区 食品 食用 农产品 信息 追溯 部分 数据
![提示](https://www.zixin.com.cn/images/bang_tan.gif)
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【曲****】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【曲****】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。
链接地址:https://www.zixin.com.cn/doc/2949394.html