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

ICS35.240

CCSL67

34

安徽省地方标准

DB34/T5135—2025

农业农村信息系统数据接口技术规范

Technicalspecificationfordatainterfaceofagricultureandruralinformationsystem

2025-01-24发布2025-02-24实施

安徽省市场监督管理局发布

DB34/T5135—2025

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由安徽省农业信息中心提出。

本文件由安徽省数据资源管理局归口。

本文件起草单位：安徽省农业信息中心、科大国创软件股份有限公司。

本文件主要起草人：李化武、丁晶晶、丁砥、高凌宇、方文红、周庆庆、梁苏丹、徐如丰、汪强强。

I

DB34/T5135—2025

农业农村信息系统数据接口技术规范

1范围

本文件规定了农业农村信息系统数据接口模型、数据接口方式和数据接口安全。

本文件适用于农业农村信息系统相互共享数据时数据接口。

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。

1

DB34/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），数据项取值的最大长度，不指定表示没有最大长度限制，为可选

元素；

2

DB34/T5135—2025

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。

3

DB34/T5135—2025

图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。

4

DB34/T5135—2025

表1接口输入参数

参数类型描述是否可空

userAccountstring用户的账号N

用户的密码，国密算法m4加

passwordstringN

密

DataStructure数据结构Y

dataDataSet数据集Y

Attachments附件集Y

5.3接口返回参数

5.3.1接口返回参数见表2。

5.3.2接口响应返回参数示例见附录B，错误信息定义见附录C。

表2接口返回参数

参数类型描述是否可空

接口成功与否的标志N

resultbool0代表成功；

1代表失败

resultMsgstring调用结果描述N

codestring返回结果编码Y

datamsgstring返回结果描述Y

recordsList数据集合Y

6数据接口安全

应符合GB/T37973和GB/T39477相关规定，农业农村信息系统应制定数据服务接口调用安全控

制策略,提供对资源服务的安全限制和安全控制措施,如身份鉴别、授权策略、访问控制机制、签名、时

间戳、安全协议等，对数据服务接口调用的参数进行限制或过滤，设置异常触发告警机制，并对数据接

口调用情况进行定期审计。

5

DB34/T5135—2025

附录A

（资料性）

接口请求参数示例

示例如下：

{

"userAccount":"xmsqxt",

"password":"xxxxxx",

"data":{

"DataStructure":{

"ResourceID":"sigdata001",

"ResourceName":"物联网信号",

"ResourceDirectoryCode":"ZG340000212002",

"ExplanatoryComment":"该数据为物联网设备直采信息，反映作物环境信息",

"DataUnitDescription":[{

"DataUnitID":"001",

"DataUnitName":"时间",

"DataType":"日期值",

"Comments":"信号的传输时间"

},{

"DataUnitID":"002",

"DataUnitName":"设备ID",

"DataType":"字符型",

"Comments":"设备的唯一编码"

},{

"DataUnitID":"003",

"DataUnitName":"信号编码",

6

DB34/T5135—2025

"DataType":"字符型",

"Comments":"设备编码"

},{

"DataUnitID":"004",

"DataUnitName":"信号值",

"DataType":"数值型",

"Comments":"信号值"

}

]},

"DataSet":{

"RecordData":[{

"UnitData":[{

"UnitID":"001",

"UnitDisplayName":"时间",

"UnitValue":"2021-10-0910:30"

},{

"UnitID":"002",

"UnitDisplayName":"设备ID",

"UnitValue":"587202813"

},{

"UnitID":"003",

"UnitDisplayName":"信号编码",

"UnitValue":"8301"

},{

"UnitID":"004",

"UnitDisplayName":"信号值",

7

DB34/T5135—2025

"UnitValue":21.3

},{

"UnitID":"001",

"UnitDisplayName":"时间",

"UnitValue":"2021-10-0910:30"

},{

"UnitID":"002",

"UnitDisplayName":"设备ID",

"UnitValue":"587202813"

},{

"UnitID":"003",

"UnitDisplayName":"信号编码",

"UnitValue":"8302"

},{

"UnitID":"004",

"UnitDisplayName":"信号值",

"UnitValue":38.6

}]

}]

}

}

}

8

DB34/T5135—2025

附录B

（资料性）

接口响应返回参数示例

示例如下：

{

“result”:”0”,

“resultMsg”:”成功”,

“data”:{

code:200,

msg:’success’,

records:[{