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

DB34/T 5135-2025《农业农村信息系统数据接口技术规范》主要内容总结

1. ​​范围​​

本标准规定了农业农村信息系统数据共享的接口模型、接口方式及安全要求，适用于系统间数据交换场景。

2. ​​规范性引用文件​​

• ​​GB/T 37973​​：信息安全技术（大数据安全管理指南）
• ​​GB/T 39477​​：政务信息共享数据安全技术要求
• ​​NY/T 3501​​：农业数据共享技术规范
• ​​DB34/T 3473​​：农业大数据信息资源目录管理

3. ​​数据接口模型​​

模型由 ​​数据结构（DataStructure）、数据集（DataSet）、附件集（Attachments）​​ 组成，后两者为可选项但至少需包含其一。

3.1 ​​数据结构​​

• ​​必选元素​​：
  • ​​数据标识（ResourceID）​​：唯一标识符
  • ​​数据名称（ResourceName）​​：业务常用名称（如“农村集体经济”）
  • ​​目录代码（ResourceDirectoryCode）​​：依据DB34/T 3473
• ​​可选元素​​：
  • ​​说明性注释（ExplanatoryComment）​​
  • ​​数据项描述（DataUnitDescription）​​：定义结构化数据的指标项，包含数据项标识、名称、类型（字符/数值/日期/二进制）、定义、长度限制及精度等。
  • ​​附件项描述（AttachmentDescription）​​：定义非结构化数据的附件项，包含附件名称、类型描述（如jpeg、gif）等。

3.2 ​​数据集​​

• 封装结构化数据，由多个 ​​数据记录（RecordData）​​ 组成，每条记录对应关系数据库中的一行。
• ​​数据项（UnitData）​​ 组成记录，包含：
  • 数据项标识符（与数据结构对应）
  • 数据项名称
  • 数据项值（二进制数据需BASE64编码）。

3.3 ​​附件集​​

• 封装非结构化数据（如文本、图像、音视频），每个附件包含：
  • ​​必选元素​​：附件标识、显示名称、类型描述、附件类型、内容。
  • ​​可选元素​​：描述信息。

4. ​​数据接口方式​​

4.1 协议

支持 ​​HTTPS、WebService​​ 等传输协议。

4.2 输入参数

• ​​必填参数​​：
  • userAccount（用户账号）
  • password（密码，国密SM4加密）
• ​​可选参数​​：
  • DataStructure（数据结构）
  • DataSet（数据集）
  • Attachments（附件集）。

4.3 返回参数

• ​​必填字段​​：
  • result（0成功/1失败）
  • resultMsg（结果描述）
• ​​可选字段​​：
  • code（结果编码，如200成功）
  • msg（详细描述）
  • records（数据集合）。

4.4 错误代码（附录C）

• 示例错误：E01（参数为空）、E04（参数超长）、E99（接口异常）。

5. ​​数据接口安全​​

• ​​安全要求​​：
  • 身份鉴别（如用户账号密码验证）
  • 访问控制与授权策略
  • 数据加密（如HTTPS传输、SM4加密密码）
  • 签名与时间戳防篡改
  • 接口调用审计与异常告警机制。
• 引用标准：GB/T 37973、GB/T 39477。

6. ​​附录​​

• ​​附录A​​：接口请求示例（包含物联网信号数据的结构及记录）。
• ​​附录B​​：接口响应示例（成功返回数据集合）。
• ​​附录C​​：错误代码表（共9类错误，如参数缺失、格式错误等）。

关键特点

• ​​灵活性​​：支持结构化与非结构化数据混合传输。
• ​​标准化​​：统一数据模型及接口协议，确保跨系统兼容性。
• ​​安全性​​：多重安全机制保障数据传输与访问安全。
• ​​扩展性​​：数据结构中预留扩展字段，适应农业数据多样性需求。