智慧农业公共服务平台物联网系统接口API文档汇编.doc
来源：新闻资讯 /
时间: 2024-11-22
智慧农业公共服务平台物联网系统接口API文档
目录
智慧农业项目物联网API文档 1
概述 3
接口说明 3
1. 传感器接口 4
概述
物联网设备开发人员根据此文档开发对应的相关接口。
serverUrl：数据服务器url路径。
允许post或get方式传送数据
接口说明
返回错误信息：
200：正常5
100：业务逻辑异常
101：业务逻辑警告
109：服务端系统未知异常
传感器模块
传感器接口(rest)
接口名称 需要登录 N 参数名称 类型 必须 作用 Jsondata Json Y 数组形式传递传感器参数 参数内部参数详细 类型 必须 作用 id String Y 传感器编号（企业自行定义，企业内必须唯一） companyId String Y 企业编号，与农委系统内企业编号一致。设置公司规则作为公司唯一标识码。 type int32 Y 数据类型：（比如0:融氧；1:PH；2:水温;3...，数据库里设置字典表维护） unit String Y 单位（%，摄氏度，ppm…） value Number Y 数值，类型为数值型，允许带小数 返回类名 属性名 类型 必须 作用 Code String Y 返回消息编码（200，100，101，109） text String Y 返回中文说明（正常，业务逻辑异常，业务逻辑警告，服务端系统未知异常） Data String Y 返回数据，预留 pageLimit String Y 分页参数，预留
范例：
url：
:8080/zhny/api/
参数名：
Jsondata
举例：
数据类型字典表：1：CO2浓度，2：空气湿度，3：空气温度，4：余水深度，5：水池温度，6：土壤湿度，7：土壤温度，8：光照度
[
{type:’1’,unit:’ppm’,value:’1206’,id:’00101’,companyid:’0’ }，
{type:’2’,unit:’%’,value:’62.30’,id:’00102’, companyid:’0’ }，
{type:’3’,unit:’0C’,value:’22.30’,id:’00103’, companyid:’0’ }，
{type:’4’,unit:’m’,value:’0.07’,id:’00104’, companyid:’0’ }，
{type:’5’,unit:’0C’,value:’16.50’,id:’00105’, companyid:’0’ }，
{type:’6’,unit:’%’,value:’19.12’,id:’00106’, companyid:’0’ }，
{type:’7’,unit:’0C’,value:’17.54’,id:’00107’, companyid:’0’ }，
{type:’8’,unit:’lux’,value:’94.5’,id:’00108’, companyid:’0’ }，
{type:’1’,unit:’ppm’’,value:’541’,id:’00109’, companyid:’0’ }，
{type:’2’,unit:’%’,value:’59.90’,id:’00110’, companyid:’0’ }，
{type:’3’,unit:’0C’,value:’14.60’,id:’00111’, companyid:’0’ }，
{type:’6’,unit:’%’,value:’19.07’,id:’00112’, companyid:’0’ }，
{type:’7’,unit:’0C’,value:’14.49’,id:’00113’, companyid:’0’ }，
{type:’8’,unit:’lux’,value:’0.80’,id:’00114’, companyid:’0’ }
]
返回结果：
{code:200,text:null，data:null,pageLimit:”” }
传感器接口(socket)
数据帧格式：
数据长度 1位 数据
数据格式同上rest接口数据，因为不清楚现在主流传感器使用字符编码格式，所以需要找几个传感器商协商下，具体使用哪种编码
技术联系人：周国强
上一篇: 工业数据采集有什么用？主要面临什么难题？
下一篇: api合作是什么意思？
