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

农业物联网平台数据交换共享指南目 次前言 II1范引文件 1语定义 11素 1I农业物联网平台数据交换共享指南范围本标准提出了种植业农业物联网采集系统与物联网平台之间对各类数据进行交换共享时对数据定义、数据共享方式与交换格式、数据安全、维护升级的建议。本标准适用于石家庄市种植业农业物联网采集系统和物联网平台间的数据交换共享。DB1301/T331—2020 下列术语和定义适用于本文件。3.1农业物联网平台agriculturalInternetofthingsinformationplatform3.2数据申请方dataapplicant数据交换中发起服务请求的一方，远程获取内容提供方的数据。3.3数据提供方dataprovider数据交换中被访问的一方，接收服务请求，通过接口为数据申请方提供数据。总则需考虑的因素数据DB1301/T331—202071农业物联网平台数据交换共享基于RESTFulAPI，采用标准JSON数据格式，HTTP传输协议。数据申请方通过GET/POST方法访问数据提供方，数据提供方应给与JSON格式字符串作为回复。图1 服务式传输过程中，数据申请方向数据提供方发出查询请求，数据提供方通过RESTFulApi接口响应请求，并返回相应的数据。报文1024k2次/codedata中直dataarray示例1：通过baseCode获取单个基地信息：请求：GET/base?baseCode复报文：HTTP/1.1200OK{“code”:200,“msg”:“获取成功”“data”:{“createDate”:“2015-01-01”,“baseCode”:“1301090001”,“baseName”:“藁城示范基地”,“info”:“建立于藁城区的测试基地”,“area”:“100”,“xzqhCode”:“130109”,“picture”:\h“/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”,“baseName”:“藁城示范基地”,“info”:“建立于藁城区的测试基地”,“area”:“100”,“xzqhCode”:“130109”,“picture”:\h“/pic/20150101/title.png”},{“createDate”:“2015-01-05”,“baseCode”:“1301090002”,“baseName”:“藁城种植基地”,“info”:“建立于藁城区的种植基地”,“area”:“180”,“xzqhCode”:“130109”,3DB1301/T332—2020“picture”:\h“/pic/20150105/title.png”}]}示例：获取设施类型列表：请求：GET/baseTypeList?page=1&pageSize=2回复报文：HTTP/1.1200OK{“code”:200,“msg”:“获取成功”,“page”:1,“totalPages”:5,“data”:[{“typeCode”:“Q001”,“unit”:“℃”,“minValue”:“-20.0”,“maxValue”:“80.0”,“precision”:“0.1”,“resolution”:“0.1”,“responseTime”:“1”,“picture”:\h“/pic/20150105/station1.png”},{“typeCode”:“V001”,“unit”:“”,“minValue”:“”,“maxValue”:“”,“precision”:“”,“resolution”:“”,“responseTime”:“0”,“picture”:\h“/pic/20150105/station2.png”}]}示例1：获取单个设施信息：请求：GET/device?dviceCode=1301090001W002Q0024回复报文：HTTP/1.1200OK{“code”:200,“msg”:“获取成功”,“data”:{“deviceCode”:“1301090001W002Q001”,“typeCode”:“Q004”,“deviceName”:“一号气象站”,“parentCode”:“1301090001W002”}}示例2：获取多个设施信息：请求：GET/devices?typeCode=Q004&page=1&pageSize=2回复报文：HTTP/1.1200OK{“code”:200,“msg”:“获取成功”,“page”:1,“totalPages”:5,“data”:[{“deviceCode”:“1301090001W002Q001”,“typeCode”:“Q004”,“deviceName”:“一号气象站”,“parentCode”:“1301090001W002”},{“deviceCode”:“1301090001W002Q002”,“typeCode”:“Q004”,“deviceName”:“二号气象站”,“parentCode”:“1301090001W002”}]}示例：获取多个传感器数据：请求：GET/data?deviceCode=1301090001W002Q001&page=1&pageSize=2回复报文：5HTTP/1.1200OK{“code”:200,“msg”:“获取成功”,“page”:1,“totalPages”:5,“data”:[{“deviceCode”:“1301090001W002Q001”,“createDate”:“2019-05-0411:13:30”,“ATC”:19.2,“AHC”:“56.3”},{“deviceCode”:“1301090001W002Q001”,“createDate”:“2019-05-0411:33:30”,“ATC”:20.1,“AHC”:“53.0”}]}示例：获取多个控制信息：请求：GET/controllHistory?deviceCode=1301090001W002C001&page=1&pageSize=2回复报文：HTTP/1.1200OK{“code”:200,“msg”:“获取成功”,“page”:1,“totalPages”:5,“data”:[{“deviceCode”:“1301090001W002C001”,“typeCode”:“C004”,“createDate”:“2019-05-0411:13:30”,“controlType”:“1”},{“deviceCode”:“1301090001W002C001”,6“typeCode”:“C004”,“createDate”:“2019-05-0411:33:30”,“controlType”:“0”}]}示例：获取多个报警信息：请求：GET/alertHistory?deviceCode=1301090001W002C001&page=1&pageSize=2回复报文：HTTP/1.1200OK{“code”:200,“msg”:“获取成功”,“page”:1,“totalPages”:5,“data”:[{“deviceCode”:“1301090001W002Q001”,“typeCode”:“Q004”,“createDate”:“2019-05-0411:13:30”,“alertType”:“值溢出”,“alertInfo”:“测量温度99.9超过最大值”},{“deviceCode”:“1301090001W002Q001”,“typeCode”:“Q004”,“createDate”:“2019-05-0411:33:30”,“alertType”:“值溢出”,“alertInfo”:“测量温度99.9超过最大值”}]}示例：获取多个种植信息：请求：GET/plantHistory?houseCode=1301090001W002&page=1&pageSize=2回复报文：HTTP/1.1200OK{“code”:200,7“msg”:“获取成功”,“page”:1,“totalPages”:5,“data”:[{“createDate”:“2019-01-0111:13:30”,“houseCode”:“1301090001W002”,“type”:“黄瓜”,“product”:“白黄瓜越冬茬”,“plantTime”:“2018-12-2100:00:00”,“period”:“苗期”},{“createDate”:“2019-04-0116:04:00”,“houseCode”:“1301090001W002”,“type”:“黄瓜”,“product”:“白黄瓜越冬茬”,“plantTime”:“2018-12-2100:00:00”,“period”:“采收期”}]}示例：获取多个农事管理信息：请求：GET/workHistory?houseCode=1301090001W002&page=1&pageSize=2回复报文：HTTP/1.1200OK{“code”:200,“msg”:“获取成功”,“page”:1,“totalPages”:5,“data”:[{“createDate”:“2019-01-0509:10:30”,“houseCode”:“1301090001W002”,“product”:“白黄瓜越冬茬”“type”:“黄瓜”,“info”:“施肥”,“productName”:“复合肥”,8“manufacturer”:“德坤”},{“createDate”:“2019-01-0815:43:00”,“houseCode”:“1301090001W002”,“prod