DB1301/T 332-2020 农业物联网平台数据交换共享指南

ICS65.020.01

B05

DB1301

石家庄市农业地方标准

DB1301/T332—2020

农业物联网平台数据交换共享指南

2020-04-14发布2020-06-14实施

石家庄市市场监督管理局发布

DB1301/T332—2020

目次

前言II

1范围1

2规范性引用文件1

3术语和定义1

4总则1

5需考虑的因素1

I

DB1301/T332—2020

前言

本标准按照GB/T1.1—2009给出的规则起草。

本标准由石家庄市农业农村局提出。

本标准主要起草单位：石家庄市农林科学研究院、北京农业信息技术研究中心。

本标准主要起草人：朱华吉、田国英、罗磊、杨英茹、孙想、黄媛、郝鹏、高欣娜、吴华瑞、李海

杰、顾静秋、武猛、李庆学、郝晓兰。

II

DB1301/T332—2020

农业物联网平台数据交换共享指南

1范围

本标准提出了种植业农业物联网采集系统与物联网平台之间对各类数据进行交换共享时对数据定

义、数据共享方式与交换格式、数据安全、维护升级的建议。

本标准适用于石家庄市种植业农业物联网采集系统和物联网平台间的数据交换共享。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

DB1301/T331—2020设施农业物联网数据采集指南

3术语和定义

下列术语和定义适用于本文件。

3.1

农业物联网平台agriculturalInternetofthingsinformationplatform

通过各种传感器、控制设备实时感知、控制生产现场参变量，提供农业生产服务的软硬件集成平台。

3.2

数据申请方dataapplicant

数据交换中发起服务请求的一方，远程获取内容提供方的数据。

3.3

数据提供方dataprovider

数据交换中被访问的一方，接收服务请求，通过接口为数据申请方提供数据。

4总则

为规范农业物联网平台间的数据交换共享工作制定本指南。农业物联网平台数据交换共享工作应符

合数据规范、传输安全、效率合理、便于迭代的基本原则。本指南适用于新建物联网系统的数据交换共

享工作，已有系统可参照执行。

5需考虑的因素

5.1数据

农业物联网平台共享交换的数据。基于种植业农业物联网设施产生的数据和人为填报数据。平台间

进行数据交换共享时，交换数据格式应符合DB1301/T331—2020第7章的规定。

1

DB1301/T332—2020

5.2数据共享

5.2.1传输方式

农业物联网平台数据交换共享基于RESTFulAPI，采用标准JSON数据格式，HTTP传输协议。数据申

请方通过GET/POST方法访问数据提供方，数据提供方应给与JSON格式字符串作为回复。

5.2.2服务方式

服务方式如图1所示：

图1服务方式

传输过程中，数据申请方向数据提供方发出查询请求，数据提供方通过RESTFulApi接口响应请求，

并返回相应的数据。

5.2.3数据交换格式

报文

数据申请方发送的请求报文内，可包含双方约定的筛选参数，如设备编码、上报时间等内容，对请

求数据内容进行筛选。

数据提供方的回复数据报文应在1024k范围内，交换频率低于2次/秒。对于长列表数据需要分页

提供，并在回复报文中包含页码和总页码字段，便于数据申请方分段处理。分页数据需允许请求方通过

参数指定获取的页码和每页长度。

回复报文必须包含“code”字段和“msg”字段。code字段表示访问状态，msg字段为访问状态文字

说明。字段内容由双方约定。

回复报文必须包含data字段，为一次请求中回复的数据体。对于数据内容是单个对象的，data中直

接返回对象属性；对于数据内容为列表的，data为array格式，内含多个回复数据。

基地信息

示例1：通过baseCode获取单个基地信息：

请求：GET/base?baseCode=1301090001

2

DB1301/T332—2020

回复报文：

HTTP/1.1200OK

{

“code”:200,

“msg”:“获取成功”

“data”:

{

“createDate”:“2015-01-01”,

“baseCode”:“1301090001”,

“baseName”:“藁城示范基地”,

“info”:“建立于藁城区的测试基地”,

“area”:“100”,

“xzqhCode”:“130109”,

“picture”:“/pic/20150101/title.png”

}

}

示例2：获取多个基地信息：

请求：GET/baseList?page=1&pageSize=2

回复报文：

HTTP/1.1200OK

{

“code”:200,

“msg”:“获取成功”,

“page”:1,

“totalPages”:5,

“data”:

[

{

“createDate”:“2015-01-01”,

“baseCode”:“1301090001”,

“baseN