DB34-T 5135-2025 农业农村信息系统数据接口技术规范

ICS35.24034TechnicalspecificationfordatainterfaceofagricultureandIDB34/T5135—2025.本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省农业信息中心提出。本文件由安徽省数据资源管理局归口。本文件起草单位：安徽省农业信息中心、科大国创软件股份有限公司。本文件主要起草人：李化武、丁晶晶、丁砥、高凌宇、方文红、周庆庆、梁苏丹、徐如丰、汪强强。DB34/T5135—20251农业农村信息系统数据接口技术规范本文件规定了农业农村信息系统数据接口模型、数据接口方式和数据接口安全。本文件适用于农业农村信息系统相互共享数据时数据接口。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T37973信息安全技术大数据安全管理指南GB/T39477信息安全技术政务信息共享数据安全技术要求NY/T3501农业数据共享技术规范DB34/T3473农业大数据信息资源目录管理3术语和定义NY/T3501界定的术语和定义适用于本文件。4数据接口模型4.1模型组成4.1.1数据接口模型（ExchangeData）由数据结构（DataStructure）、数据集（DataSet）和附件集（Attachments）组成。数据结构用来描述信息内容的结构信息，数据集用来封装结构化数据，附件集用来封装非结构化数据。4.1.2数据结构为必含项，数据集和附件集为可选项，但至少含有一个。4.2数据结构4.2.1数据结构由数据标识、数据名称、农业农村信息资源目录代码、说明性注释、数据项描述、附件项描述6个元素组成，数据结构见示意见图1。2DB34/T5135—2025图1数据结构示意图4.2.2数据标识（ResourceID），具有唯一性，为必选元素。4.2.3数据名称（ResourceName），可以采用农业数据的常用名称，如农村集体经济、高标准农田、主要农产品产量等，为必选元素。4.2.4农业农村信息资源目录代码（ResourceDirectoryCode）详见DB34/T3473文件，为必选元素。4.2.5说明性注释（ExplanatoryComment），用于对数据进行补充性、提示性说明，为可选元素。4.2.6数据项描述（DataUnitDescription构成结构化数据的最小单元，一个DataUnitDescription描述一个指标项的结构。为可选元素，可以出现多次。数据项描述由数据项标识、数据项名称、数据类型、数据项定义、数据项备注、最大长度、最小长度、精度8个元素组成：a)数据项标识（DataUnitID），数据项的唯一标识符，为必选元素；b)数据项名称（DataUnitName），采用业务中惯用的名称作为数据项名称，如粮食产量、肉类产量、水产品产量等名称。为必选元素；c)数据类型（DataType），可采用但不限于以下4种：字符型、数值型、日期型、二进制等，为必选元素；d)数据项定义（Definition），为可选元素；e)数据项备注（Comments），为可选元素；f)最大长度（MaximumSize），数据项取值的最大长度，不指定表示没有最大长度限制，为可选DB34/T5135—20253g)最小长度（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/T5135—20254图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。DB34/T5135—20255表1接口输入参数N用户的密码，国密算法m4加密NYYY5.3接口返回参数5.3.1接口返回参数见表2。5.3.2接口响应返回参数示例见附录B，错误信息定义见附录C。表2接口返回参数参数类型描述是否可空resultbool接口成功与否的标志0代表成功；NresultMsgstring调用结果描述Ndatacodestring返回结果编码Ymsgstring返回结果描述YrecordsList数据集合Y6数据接口安全应符合GB/T37973和GB/T39477相关规定，农业农村信息系统应制定数据服务接口调用安全控制策略,提供对资源服务的安全限制和安全控制措施,如身份鉴别、授权策略、访问控制机制、签名、时间戳、安全协议等，对数据服务接口调用的参数进行限制或过滤，设置异常触发告警机制，并对数据接口调用情况进行定期审计。DB34/T5135—20256接口请求参数示例示例如下：{"userAccount":"xmsqxt","password":"xxxxxx","data":{"DataStructure":{"ResourceID":"sigdata001","ResourceName":"物联网信号","ResourceDirectoryCode":"ZG340000212002","ExplanatoryComment":"该数据为物联网设备直采信息，反映作物环境信息","DataUnitDescription":[{"DataUnitID":"001","DataUnitName":"时间","Comments":"信号的传输时间""DataUnitID":"002","DataUnitName":"设备ID","DataType":"字符型","Comments":"设备的唯一编码""DataUnitID":"003","DataUnitName":"信号编码",DB34/T5135—20257"DataType":"字符型","Comments":"设备编码""DataUnitID":"004","DataUnitName":"信号值","DataType":"数值型","Comments":"信号值"}"DataSet":{"RecordData":[{"UnitID":"001","UnitDisplayName":"时间","UnitValue":"2021-10-0910:30""UnitID":"002","UnitDisplayName":"设备ID","UnitValue":"587202813""UnitID":"003","UnitDisplayName":"信号编码","UnitValue":"8301""UnitID":"004","UnitDisplayName":"信号值",DB34/T5135—20258"UnitValue":21.3"UnitID":"001","UnitDisplayName":"时间","UnitValue":"2021-10-0910:30""UnitID":"002","UnitDisplayName":"设备ID","UnitValue":"587202813""UnitID":"003","UnitDisplayName":"信号编码","UnitValue":"8302""UnitI