ICS 35.240 CCS L 67 34 安徽省 地方 标准 DB34/T 5135—2025 农业农村信息系统数据接口技术规范 Technical specification for data interface of agriculture and rural information system 2025 - 01 - 24发布 2025 - 02 - 24实施 安徽省市场监督管理局 发布 DB34/T 5135 —2025 I 前言 本文件按照 GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由安徽省农业信息中心提出。 本文件由安徽省数据资源管理局归口。 本文件起草单位：安徽省农业信息中心、科大国创软件股份有限公司。 本文件主要起草人：李化武、丁晶晶、丁砥、高凌宇、方文红、周庆庆、梁苏丹、徐如丰、汪强强。 DB34/T 5135 —2025 1 农业农村信息系统数据接口技术规范 1 范围 本文件规定了农业农村信息系统数据接口模型、数据接口方式和数据接口安全。 本文件适用于农业农村信息系统相互共享数据时数据接口。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 37973 信息安全技术 大数据安全管理指南 GB/T 39477 信息安全技术 政务信息共享 数据安全技术要求 NY/T 3501 农业数据共享技术规范 DB34/T 3473 农业大数据信息资源目录管理 3 术语和定义 NY/T 3501 界定的术语和定义适用于本文件。 4 数据接口模型 模型组成 4.1 4.1.1 数据接口模型（ ExchangeData ）由数据结构（ DataStructure ）、数据集（ DataSet）和附件集 （Attachments ）组成。数据结构用来描述信息内容的结构信息，数据集用来封装结构化数据，附件集 用来封装非结构化数据。 4.1.2 数据结构为必含项，数据集和附件集为可选项，但至少含有一个。 数据结构 4.2 4.2.1 数据结构由数据标识、数据名称、农业农村信息资源目录代码、说明性注释、数据项描述、附 件项描述 6个元素组成，数据结构见示意见图 1。 DB34/T 5135 —2025 2 图1 数据结构示意图 4.2.2 数据标识（ ResourceID ），具有唯一性，为必选元素。 4.2.3 数据名称（ ResourceName ），可以采用农业数据的常用名称，如农村集体经济、高标准农田、 主要农产品产量等，为必选元素。 4.2.4 农业农村信息资源目录代码（ ResourceDirectoryCode ）详见DB34/T 3473 文件，为必选元素。 4.2.5 说明性注释（ ExplanatoryComment ），用于对数据进行补充性、提示性说明，为可选元素。 4.2.6 数据项描述 （ DataUnitDescription ） ， 构成结构化数据的最小单元， 一个 DataUnitDescription 描述一个指标项的结构 。为可选元素，可以出现多次。数据项描述由数据项标识、数据项名称、数据类 型、数据项定义、数据项备注、最大长度、最小长度、精度 8个元素组成： a) 数据项标识（ DataUnitID ），数据项的唯一标识符，为必选元素； b) 数据项名称（ DataUnitName ），采用业务中惯用的名称作为数据项名称，如粮食产量、肉类 产量、水产品产量等名称。为必选元素； c) 数据类型（ DataType ），可采用但不限于以下 4种：字符型、数值型、日期型、二进制等， 为必选元素； d) 数据项定义（ Definition ），为可选元素； e) 数据项备注（ Comments ），为可选元素； f) 最大长度（ MaximumSize ），数据项取值的最大长度，不指定表示没有最大长度限制，为可选 元素； DB34/T 5135 —2025 3 g) 最小长度（ MinimumSize ），数据项取值的最小长度，不指定表示没有最小长度限制，为可选 元素； h) 精度（Scale），数值型数据项的精度，即小数点后的位数，不指定表示没有精度限制，为可 选元素； i) 扩展（Extend）针对农业数据的多样性及复杂性，预留字段扩展能力，为可选元素； j) 附件项描述（ AttachmentDescription ），构成非结构化数据的最小单元，一 个附件项描述一 个指标项的结构。可以出现多次，为可选元素； k) 附件名称（ AttachmentName ），单个附件项的名称，为必选元素。 数据集 4.3 4.3.1 数据集用来封装结构化数据。数据集由一个或多个数据记录组成，数据集示意见图 2。 图2 数据集示意图 4.3.2 数据记录（ RecordData ），组成数据集的基本单元，表示一条记录，如关系数据库表的一行或 电子表格的一行。数据记录由一个或多个数据项组成，为必选元素。 4.3.3 数据项（ UnitData ），组成数据记录的基本单元，如关系数据库中表的某个字段或电子表格的 某个单元格。数据项由数据项标识符 、数据项名称和数据项值 3个元素组成。 a) 数据项标识符（ UnitID），数据项的标识符，与数据结构中的某个数据项对应，为必选元素； b) 数据项名称（ UnitDisplayName ），数据项的名称，为必选元素； c) 数据项值 （UnitValue），数据项的值 。对二进制类型的值采用 BASE64编码。为必选元素。 附件集 4.4 4.4.1 附件集用来封装非结构化数据，如农村土地承包经营权合同等文本数据、病虫害识别等图像数 据、农业物联网监控等音视频数据。 4.4.2 单个附件（ Attachment ），是封装非结构化文件的基本单元。单个附件由附件标识、显示名称、 描述、类型描述、附件类型、附件内容 6个元素组成，附件集示意见图 3。 DB34/T 5135 —2025 4 图3 附件集示意图 4.4.3 附件标识（ AttachmentlD ），用于唯一标识该附件的标识符，为必选元素。 4.4.4 显示名称（ AttachmentDisplayName ），为必选元素。 4.4.5 描述（Description ），对该附件的解释性信息，为可选元素。 4.4.6 类型描述（ TypeDescription ），为必选元素。 4.4.7 附件类型（ AttachmentType ），附件类型描述的补充，如 jpeg、gif等，为必选元素。 4.4.8 附件内容（ Content），为必选元素。 5 数据接口方式 接口协议 5.1 数据接口服务可采用 https、WebService 等协议进行数据传输。 接口输入参数 5.2 5.2.1 接口输入参数类型、描述见表 1。 5.2.2 接口请求参数示例见附录 A。