ICS35.240.99 CCSL78 53 云南省地方标准 DB53/T1136.3—2022 食品安全信息追溯基础技术规范 第3部分：数据接口 2022-10-26发布 2023-01-26实施 云南省市场监督管理局  发布 DB53/T1136.3—2022 I前言 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草。 本文件是DB53/T1136《食品安全信息追溯基础技术规范》的第3部分。DB53/T1136一共发布以下3 个部分： ——第1部分：编码方法； ——第2部分：数据元； ——第3部分：数据接口。 请注意本文件的某些内容可能涉及及专利。本文件的发布机构不承担识别专利的责任。 本文件由云南省市场监督管理局提出并归口。 本文件起草单位：云南省市场监督管理局信息中心、云南省市场监督管理局、云南省标准化研究院、 中国移动通信集团云南有限公司、云南省盐业有限公司、云南鼎耀信息技术有限公司、昆明雪兰牛奶有 限责任公司、云南绿A生物工程有限公司。 本文件主要起草人：杨东霞、张娴、陈红丽、杨亚琦、杨增鸿、谢波、朱勋程、赵忆宁、李宁、黄 典一、杨俊、韩骥、赵欣、易正禹、邹汉铮、桑月军、宋治金、李文媛、陈福波、朱宁、林男、杨志、 金荣、段玉娟、荀春、余凡、左仕陆、杨康定。 DB53/T1136.3—2022 II引言 食品安全始终是关系国计民生的大事。追溯体系的建立作为保障食品安全的重要管理手段一直是社 会关注的重点工作。从国内外追溯体系建设和实施的成效可以看出，建立追溯体系是一种能够预防和改 善食品安全问题的有效途径。在信息化技术应用于追溯体系建设过程中，追溯编码、数据元和数据接口 是重要的基础性工作。科学制定标准规范有利于实现追溯数据互联互通和追溯体系的推广应用。《食品 安全信息追溯基础技术规范》拟由三个部分构成： ——第1部分：编码方法。目的在于给出食品安全追溯体系中追溯码编码方法和表示要求； ——第2部分：数据元。目的在于给出食品安全追溯体系中基础数据元及其描述规则； ——第3部分：数据接口。目的在于给出食品安全追溯体系中生产企业数据上传信息的接口要求。 DB53/T1136.3—2022 1食品安全信息追溯基础技术规范第3部分：数据接口 1范围 本文件规定了食品安全信息追溯的数据接口技术要求、数据接口参数和接口安全。 本文件适用于食品安全信息追溯的数据交换、传输和认证。 2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T7408数据元和交换格式信息交换日期和时间表示法 GB/T7635.1全国主要产品分类与代码第1部分：可运输产品 GB12904商品条码零售商品编码与条码表示 GB/T38155重要产品追溯追溯术语 RFC1945超文本传输协议1.0(Hypertexttransferprotocol--HTTP/1.0) RFC2616超文本传输协议1.1(Hypertexttransferprotocol--HTTP/1.1) RFC4627JSON格式定义(Theapplication/JSONmediatypeforjavascriptObjectnotation) RFC4825可扩展标记语言配置接入协议(Theextensiblemarkuplanguage(XML)configuration accessprotocol(XCAP)) 3术语和定义 下列术语和定义适用于本文件。 数据接口datainterface 一组用于数据交换的服务，包括服务的功能、位置以及通讯的协议、传输格式和认证方法。 接口协议interfaceprotocol 需要进行信息交换的接口间需要遵从的通信方式和要求。其内容包括协议约定、消息头域、消息体 内容等，确定通信程序发送消息和接收消息的规则。 消息头MessageHeader 消息头包含了关于消息本身的元数据（例如，发送者和目标详细信息、消息属性、消息类型），不 同传输的头包含不同类型的信息。 安全认证securitycertificate 保证数据传输安全的加密方法和身份认证方法。 “名称/值”对name/valuepair DB53/T1136.3—2022 2JSON的数据存储格式，“名称/值”对组合中的名称写在前面双引号中，值写在后面双引号中，中 间用冒号隔开，“名称/值”对之间由逗号分隔。 追溯码traceabilitycode 追溯系统中对追溯单元进行唯一标识的代码。 [来源：GB/T38155—2019，2.10] 4缩略语 下列缩略语适用于本文件。 HTTPS：安全超文本传输协议（HyperTextTransferProtocoloverSecureSocketLayer） JSON：一种轻量级的数据交换格式(JavaScriptObjectNotation) MD5：消息摘要算法第五版（Message-DigestAlgorithm5） RESTFul：基于HTTPS协议，可以使用XML格式定义或JSON格式定义 Token：是服务端生成的一串加密字符串、以作客户端进行请求的一个“令牌” URL：互联网服务程序上用于指定信息位置的表示方法（UniformResourceLocator） UTF-8：一种可变长度字符编码(8-bitUnicodeTransformationFormat) XML：可扩展标记语言（ExtensibleMarkupLanguage） 5技术要求 基本要求 5.1.1接口要求 接口通过服务调用实现信息交换，应符合下列要求： ——采用符合GB/T7408规定的日期类型； ——接口请求与接口响应均采用JSON数据格式； ——建立接口日志记录，能识别数据异常或追溯交换数据情况。 5.1.2容错要求 发生错误时，接口服务方将详细的错误信息返回至接口调用方，由接口调用方对错误进行记录分析 和整改。 接口协议 接口协议方式包括： ——采用基于HTTPS传输协议的RESTFul接口方式； ——采用JSON格式报文打包方式。 消息头基本参数 5.3.1安全认证接口Header参数 安全认证接口Header参数见表1。 DB53/T1136.3—2022 3表1安全认证接口Header参数表 参数名称 参数描述 Authorization接口授权 （其余字段）采用默认值 5.3.2业务交互接口Header参数 业务交互接口Header参数见表2。 表2业务交互接口Header参数表 参数名称 参数描述 Authorization接口授权 Trace-Auth授权token，格式为：bearer+token例如： bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJpc3N1c2VyIiwiYXVkIjoiYXVkaWVuY2UiL CJ0ZW5hbnRfaWQiOiIwMDAwMDAiLCJ1c2VyX25hbWUiOiLkupHljZfkupHpgJ_kv6Hmga_mioDmnK_mnIn pmZDlhazlj7giLCJ0b2tlbl90eXBlIjoiYWNjZXNzX3Rva2VuIiwicm9sZV9uYW1lIjoiZW50ZXJwcmlzZ SIsInVzZXJfdHlwZSI6Im1hc3RlciIsInVzZXJfaWQiOiI5OTY0NTgzMDUxMTgxMjE4MyIsInJvbGVfaWQ iOiIxNDAyNDM3NTkyMDc4NzQ5Njk3Iiwibmlja19uYW1lIjoi5LqR5Y2X5LqR6YCf5L-h5oGv5oqA5pyv5 pyJ6ZmQ5YWs5Y-4IiwiZGV0YWlsIjp7InR5cGUiOiJ3ZWIifSwiZW50ZXJwcmlzZV9jb2RlIjoiOTE1MzA xMDJNQTZLNEtBNTdRIiwiZGVwdF9pZCI6IjIzNyIsImFjY291bnQiOiI5MTUzMDEwMk1BNks0S0E1N1EiL CJjbGllbnRfaWQiOiJzYWJlciIsImV4cCI6MTY1NTM3MDM4MCwibmJmIjoxNjU1MzY2NzgwfQ.M8o2wrI6 eKb9JovCDKLGhZVAB4k4tmwA-GmUGEGzZ71zCStoL62e0vmRlzppuniuOcvQa8cbqHyz1E_uk-MyEQ （其余字段）采用默认值 基本数据类型 基本数据类型说明见表3。 表3数据类型说明表 类型名称 类型说明 String 字符串 Integer 整型 File 文件类型 Datetime 日期格式：yyyymmdd,依据GB/T7408 Array 数组类型 Boolean 布尔类型。真值：true；假值：false Object JSON对象类型 6数据接口 数据接口分类 DB53/T1136.3—2022 4数据接口分类见图1所示。 图1数据接口分类 基本信息接口 6.2.1安全认证接口 获取用户登录token信息，进行用户安全认证，相关参数见表4。 表4安全认证接口数据 参数名称 数据类型 长度（Byte）是否必填 描述 userName String 32 是 用户名，企业统一社会信用代码 passWord String 45 是 登录密码，密码使用MD5加密 tenanIId