智慧农业公共服务平台物联网系统接口API文档汇编.doc

智慧农业公共服务平台物联网系统接口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接口数据，因为不清楚现在主流传感器使用字符编码格式，所以需要找几个传感器商协商下，具体使用哪种编码 技术联系人：周国强