一、統(tǒng)一說明
1、通訊方式
數(shù)據(jù)接口采用http協(xié)議，通訊內(nèi)容采用JSON數(shù)據(jù)格式。
接口返回數(shù)據(jù)格式如下：
{"code":1001, "message":"信息內(nèi)容", "data":object}
ResultData字段說明
|
字段 |
類型 |
說明 |
|
code |
Integer |
代碼(參考返回代碼說明表) |
|
message |
String |
返回操作結(jié)果描述 |
|
data |
Json |
Json數(shù)據(jù)，具體格式參考各個接口 |
文檔中所有接口的返回數(shù)據(jù)說明表，如無特殊說明均為ResultData數(shù)據(jù)格式，返回的數(shù)據(jù)均存放于data字段中
-
接口調(diào)用注意事項：
調(diào)用接口（除登錄接口外）需要將token寫入http請求頭中。請求頭字段名 固定為token，字段值可通過登錄接口獲取。
接口中如無特殊說明，采用post方法的接口中參數(shù)為json格式；采用get方法的接口 中參數(shù)為查詢參數(shù)，放入請求地址后
-
接口地址
正式接口地址： http://farm.0531yun.cn
二、接口詳細(xì)
1、登錄操作
1.1 登錄
1.1.1接口描述
|
接口編號 |
1.1 |
|
接口名稱 |
登錄接口 |
|
功能描述 |
用戶登錄 |
|
接口地址 |
/customUser/Login |
|
請求方式 |
POST |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表1.1.1.1
1.1.2請求參數(shù)說明
|
字段 |
類型 |
說明 |
|
loginName |
String |
登錄名 |
|
loginPwd |
String |
密碼 |
表1.1.2.1
1.1.3返回數(shù)據(jù)說明
|
參數(shù)名 |
類型 |
說明 |
|
code |
string |
1000,”登錄成功” |
|
message |
string |
無 |
|
data |
object |
無 |
|
token |
string |
token |
|
expDate |
string |
token過期時間 |
|
currDate |
string |
token開始時間 |
|
loginSign |
string |
登錄標(biāo)識 |
表1.1.3.1
1.1.4返回格式示例
{
"code": 1000,
"data": {
"token": "eyJhbGciOiJIUzI1NiJ9.eyJsb2dpbm5hbWUiOiJtYXN0ZXIiLCJleHAiOjE2MjA2NDIyMDIsInVzZXJpZCI6IjAiLCJpYXQiOjE2MjA2MzUwMDIsImp0aSI6InRva2VuSWQifQ.pUgt6TnUznLIbUi-aXkqsOMpXcaenviMacxD5TaLcXA",
"expDate": 1620642202287,
"currDate": 1620635002287,
"loginSign": "0"
},
"message": "登錄成功"
}
2、區(qū)域操作
2.1 用戶區(qū)域分組
2.1.1接口描述
|
接口編號 |
2.1 |
|
接口名稱 |
用戶區(qū)域分組 |
|
功能描述 |
獲取用戶區(qū)域分組 |
|
接口地址 |
/UserGroup/UserGroup |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表2.1.1.1
2.1.2請求參數(shù)說明
2.1.2.1請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表2.1.2.1.1
2.1.3返回數(shù)據(jù)說明
|
參數(shù)名 |
類型 |
說明 |
|
code |
string |
1000,”操作成功” |
|
message |
string |
無 |
|
data |
array |
無 |
|
groupId |
string |
區(qū)域id |
|
groupName |
string |
區(qū)域名稱 |
|
createTime |
string |
無 |
|
remark |
string |
備注 |
|
deviceDOS |
array |
設(shè)備信息 |
|
deviceAddr |
string |
蟲情設(shè)備地址碼 |
|
deviceType |
string |
設(shè)備類型 0:蟲情設(shè)備，1:氣象設(shè)備，2:攝像頭，3:墑情設(shè)備4:孢子分析設(shè)備 5灌溉設(shè)備 |
|
deviceName |
string |
設(shè)備名稱 |
|
lng |
string |
經(jīng)度 |
|
lat |
string |
緯度 |
|
saveDateInterval |
string |
數(shù)據(jù)保存間隔 |
|
offlineInterval |
string |
離線判斷間隔 |
|
httpUrl |
object |
攝像頭httpUrl |
|
rtmpUrl |
object |
攝像頭rtmpUrl |
|
city |
object |
城市 |
表2.1.3.1
2.1.4返回格式示例
{
"code": 1000,
"data": [
{
"groupId": "0F47931769AEE0B414700782E3F3FA72",
"groupName": "測試",
"createTime": 1620700613000,
"remark": "測試",
"deviceDOS": [
{
"deviceAddr": "12345602",
"deviceType": 0,
"deviceName": "12345602",
"lng": 0,
"lat": 0,
"saveDateInterval": 5,
"offlineInterval": 5,
"groupId": "0F47931769AEE0B414700782E3F3FA72",
"httpUrl": null,
"rtmpUrl": null,
"city": null,
"createTime": 1619576457000
}
]
}
],
"message": "操作成功"
}
3.設(shè)備操作
3.1 獲取氣象設(shè)備詳細(xì)信息
3.1.1 接口描述
|
接口編號 |
3.1 |
|
接口名稱 |
獲取氣象設(shè)備詳細(xì)信息 |
|
功能描述 |
獲取氣象設(shè)備詳細(xì)信息 |
|
接口地址 |
/UserDevice/UserDeviceParticulars |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表3.1.1.1
3.1.2 請求參數(shù)說明
3.1.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表3.1.2.1.1
3.1.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
無 |
表3.1.2.2.1
3.1.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
1000,”操作成功” |
|
message |
string |
無 |
|
data |
array |
無 |
|
termId |
string |
節(jié)點id |
|
termName |
string |
節(jié)點名稱 |
|
termNo |
string |
節(jié)點編號 |
|
enabled |
string |
節(jié)點使能，0關(guān)閉，1開啟 |
|
deviceAddr |
string |
設(shè)備地址id |
|
level |
string |
優(yōu)先級 |
|
nodeType |
string |
//1: 模擬量1使能模擬量2使能 //2: 模擬量1使能模擬量2禁用 //3: 模擬量1禁用模擬量2使能 //4: 浮點型設(shè)備 //5: 開關(guān)量型設(shè)備 //6: 32位有符號整形 //7: 32位無符號整形 //8:遙調(diào)設(shè)備 |
|
temName |
string |
模擬量1名稱 |
|
humName |
string |
模擬量2名稱 |
|
temTag |
string |
模擬量1單位 |
|
humTag |
string |
模擬量2單位 |
|
temCoefficient |
string |
模擬量1系數(shù) |
|
humCoefficient |
string |
模擬量2系數(shù) |
|
temOffset |
string |
模擬量1偏差 |
|
humOffset |
string |
模擬量2偏差 |
|
temMax |
string |
溫度上限值 |
|
temMin |
string |
溫度下限值 |
|
humMax |
string |
濕度上限值 |
|
humMin |
string |
濕度下限值 |
|
digits |
string |
小數(shù)位數(shù) |
|
switchOnText |
string |
開關(guān)量閉合內(nèi)容 |
|
switchOffText |
string |
開關(guān)量斷開內(nèi)容 |
|
switchAlarmType |
string |
開關(guān)量報警類型（0 不報警 1閉合報警 2斷開報警） |
|
weatherTermRegualtingDOS |
array |
無 |
|
regularNo |
string |
檔位 |
|
regularValue |
string |
值 |
|
regularText |
string |
顯示內(nèi)容 |
|
alarm |
string |
報警開關(guān)，0不報警，1報警 |
|
regulatingId |
string |
無 |
表3.1.3.1
3.1.4 返回格式示例
{
"code": 1000,
"data": [
{
"termId": 1,
"termName": "測試節(jié)點",
"termNo": 1,
"enabled": 1,
"deviceAddr": "10000001",
"level": 2,
"nodeType": 5,
"temName": "11",
"humName": "濕度",
"temTag": "℃",
"humTag": "%RH",
"temCoefficient": 0.1,
"humCoefficient": 0,
"temOffset": 0.1,
"humOffset": 0,
"temMax": 50,
"temMin": 10,
"humMax": 100,
"humMin": 0,
"digits": 2,
"switchOnText": "12",
"switchOffText": "23",
"switchAlarmType": 2,
"weatherTermRegualtingDOS": []
},
{
"termId": 8,
"termName": "節(jié)點8",
"termNo": 8,
"enabled": 0,
"deviceAddr": "10000001",
"level": 6,
"nodeType": 8,
"temName": "測試測試遙調(diào)",
"humName": "濕度",
"temTag": "℃",
"humTag": "%RH",
"temCoefficient": 0.1,
"humCoefficient": 0.2,
"temOffset": 0,
"humOffset": 1,
"temMax": 100,
"temMin": 0,
"humMax": 200,
"humMin": 10,
"digits": 1,
"switchOnText": "",
"switchOffText": "",
"switchAlarmType": 0,
"weatherTermRegualtingDOS": [
{
"regulatingId": 377,
"termId": null,
"regularNo": 14,
"regularValue": 13,
"regularText": "",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 376,
"termId": null,
"regularNo": 13,
"regularValue": 12,
"regularText": "",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 375,
"termId": null,
"regularNo": 12,
"regularValue": 11,
"regularText": "",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 374,
"termId": null,
"regularNo": 11,
"regularValue": 10,
"regularText": "",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 373,
"termId": null,
"regularNo": 10,
"regularValue": 9,
"regularText": "",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 372,
"termId": null,
"regularNo": 9,
"regularValue": 8,
"regularText": "",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 371,
"termId": null,
"regularNo": 8,
"regularValue": 7,
"regularText": "西北風(fēng)",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 370,
"termId": null,
"regularNo": 7,
"regularValue": 6,
"regularText": "西風(fēng)",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 369,
"termId": null,
"regularNo": 6,
"regularValue": 5,
"regularText": "西南風(fēng)",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 368,
"termId": null,
"regularNo": 5,
"regularValue": 4,
"regularText": "南風(fēng)",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 367,
"termId": null,
"regularNo": 4,
"regularValue": 3,
"regularText": "東南風(fēng)",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 366,
"termId": null,
"regularNo": 3,
"regularValue": 2,
"regularText": "東北風(fēng)",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 365,
"termId": null,
"regularNo": 2,
"regularValue": 1,
"regularText": "東風(fēng)",
"alarm": 0,
"deviceAddr": null
},
{
"regulatingId": 364,
"termId": null,
"regularNo": 1,
"regularValue": 0,
"regularText": "北風(fēng)",
"alarm": 1,
"deviceAddr": null
},
{
"regulatingId": 378,
"termId": null,
"regularNo": 15,
"regularValue": 14,
"regularText": "",
"alarm": 0,
"deviceAddr": null
}
]
},
{
"termId": 9,
"termName": "節(jié)點9",
"termNo": 9,
"enabled": 1,
"deviceAddr": "10000001",
"level": 0,
"nodeType": 5,
"temName": "溫度",
"humName": "濕度",
"temTag": "℃",
"humTag": "%RH",
"temCoefficient": 0.1,
"humCoefficient": 0.1,
"temOffset": 0,
"humOffset": 0,
"temMax": 100,
"temMin": 0,
"humMax": 100,
"humMin": 0,
"digits": 2,
"switchOnText": "1",
"switchOffText": "1",
"switchAlarmType": 0,
"weatherTermRegualtingDOS": []
}
],
"message": "操作成功"
}
3.2 獲取設(shè)備信息歷史記錄
3.2.1接口描述
|
接口編號 |
3.2 |
|
接口名稱 |
獲取設(shè)備信息歷史記錄 |
|
功能描述 |
獲取設(shè)備信息歷史記錄 |
|
接口地址 |
/UserDevice/WeatherDeviceHistory |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表3.2.1.1
3.2.2 請求參數(shù)說明
3.2.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表3.2.2.1.1
3.2.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
startTime |
是 |
string |
開始時間 |
|
endTime |
是 |
string |
結(jié)束時間 |
表3.2.2.2.1
3.2.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
array |
無 |
|
id |
string |
無 |
|
deviceAddr |
string |
設(shè)備地址ID |
|
termId |
string |
節(jié)點ID |
|
tem |
string |
模擬量1 |
|
hum |
string |
模擬量2 |
|
createTime |
string |
時間 |
|
isAlarm |
string |
//0:正常 //1:報警 |
表3.2.3.1
3.2.4 返回格式示例
{
"code": 1000,
"data": [
{
"id": 14,
"deviceAddr": "10000001",
"termId": 1,
"tem": "100",
"hum": "100",
"createTime": 1618365553000,
"isAlarm": 1
},
{
"id": 12,
"deviceAddr": "10000001",
"termId": 1,
"tem": "50",
"hum": "23.3",
"createTime": 1618365689000,
"isAlarm": 1
},
{
"id": 15,
"deviceAddr": "10000001",
"termId": 1,
"tem": "1",
"hum": "20.3",
"createTime": 1618367552000,
"isAlarm": 0
}
],
"message": "操作成功"
}
3.3 獲取蟲情設(shè)備歷史記錄
3.3.1 接口描述
|
接口編號 |
3.3 |
|
接口名稱 |
獲取蟲情設(shè)備歷史記錄 |
|
功能描述 |
獲取蟲情設(shè)備歷史記錄 |
|
接口地址 |
/UserDevice/WormDeviceHistory |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表3.3.1.1
3.3.2 請求參數(shù)說明
3.3.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表3.3.2.1.1
3.3.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
startTime |
是 |
string |
開始時間 |
|
endTime |
是 |
string |
結(jié)束時間 |
表3.3.2.2.1
3.3.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
array |
無 |
|
recordId |
string |
無 |
|
deviceAddr |
string |
設(shè)備地址ID |
|
value |
string |
數(shù)據(jù) |
|
createTime |
string |
無 |
表3.3.3.1
3.3.4 返回格式示例
{
"code": 1000,
"data": [
{
"recordId": 2,
"deviceAddr": "10000000",
"value": "殺蟲倉溫度: 離線|烘干倉溫度: 離線|電池電量: 離線|降雨狀態(tài):無|光照度: 離線|誘蟲燈狀態(tài):無",
"createTime": 1618982274000
},
{
"recordId": 1,
"deviceAddr": "10000000",
"value": "殺蟲倉溫度: 離線|烘干倉溫度: 離線|電池電量: 離線|降雨狀態(tài):無|光照度: 離線|誘蟲燈狀態(tài):無",
"createTime": 1618970306000
}
],
"message": "操作成功"
}
3.4 蟲情設(shè)備分析報表記錄
3.4.1接口描述
|
接口編號 |
3.4 |
|
接口名稱 |
蟲情設(shè)備分析報表記錄 |
|
功能描述 |
蟲情設(shè)備分析報表記錄 |
|
接口地址 |
/UserDevice/WormAnalyzeReport |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表3.4.1.1
3.4.2 請求參數(shù)說明
3.4.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表3.4.2.1.1
3.4.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
startTime |
是 |
string |
開始時間 |
|
endTime |
是 |
string |
結(jié)束時間 |
表3.4.2.2.1
3.4.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
array |
無 |
|
recordId |
string |
無 |
|
deviceAddr |
string |
設(shè)備地址ID |
|
analyst |
string |
分析員 |
|
createTime |
string |
添加時間 |
|
verifyTime |
string |
分析時間 |
|
remark |
string |
備注 |
|
imagesUrl |
string |
拍照圖片路徑 |
|
analyseData |
string |
害蟲種類及數(shù)量 |
|
analyseCoord |
string |
分析坐標(biāo) |
|
analyseCoordUrl |
string |
分析坐標(biāo)圖片路徑 |
表3.4.3.1
3.4.4 返回格式示例
{
"code": 1000,
"data": [
{
"recordId": 142,
"deviceAddr": "12345601",
"analyst": "AI",
"createTime": 1620616602000,
"verifyTime": 1620618019000,
"remark": "",
"imagesUrl": "http://farm.0531yun.cn../../static/wormImages/1212121212.png",
"analyseData": "[{\"name\":\"蚜蟲\",\"num\":\"10\"}]",
"analyseCoord": null,
"analyseCoordUrl": null
},
{
"recordId": 141,
"deviceAddr": "12345601",
"analyst": "11",
"createTime": 1620616589000,
"verifyTime": 1620617889000,
"remark": "1",
"imagesUrl": "http://farm.0531yun.cn../../static/wormImages/111-big.png",
"analyseData": "[{\"name\":\"小白蛾\",\"num\":\"1\"},{\"name\":\"玉米螟\",\"num\":\"1\"}]",
"analyseCoord": null,
"analyseCoordUrl": null
},
{
"recordId": 140,
"deviceAddr": "12345601",
"analyst": "",
"createTime": 1620616308000,
"verifyTime": 1620617828000,
"remark": "1",
"imagesUrl": "http://farm.0531yun.cn../../static/wormImages/111-big.png",
"analyseData": "[{\"name\":\"玉米螟\",\"num\":\"1\"}]",
"analyseCoord": null,
"analyseCoordUrl": null
},
{
"recordId": 121,
"deviceAddr": "12345601",
"analyst": "1",
"createTime": 1620604468000,
"verifyTime": 1620617809000,
"remark": "1",
"imagesUrl": "http://farm.0531yun.cn../../static/wormImages/1212121212.png",
"analyseData": "[{\"name\":\"玉米螟\",\"num\":\"2\"}]",
"analyseCoord": null,
"analyseCoordUrl": null
}
],
"message": "操作成功"
}
3.5 獲取設(shè)備實時數(shù)據(jù) 氣象
3.5.1接口描述
|
接口編號 |
3.5 |
|
接口名稱 |
獲取設(shè)備實時數(shù)據(jù) 氣象 |
|
功能描述 |
獲取設(shè)備實時數(shù)據(jù) 氣象 |
|
接口地址 |
/UserDevice/WeatherDeviceRealData |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表3.5.1.1
3.5.2 請求參數(shù)說明
3.5.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表3.5.2.1.1
3.5.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
表3.5.2.2.1
3.5.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
deviceAddr |
string |
設(shè)備地址 |
|
deviceName |
string |
設(shè)備名稱 |
|
deviceType |
string |
設(shè)備識別號1:氣象設(shè)備，3:墑情設(shè)備 |
|
lat |
string |
維度 |
|
lng |
string |
經(jīng)度 |
|
status |
string |
狀態(tài) online,offline,alarm |
|
terms |
array |
節(jié)點 |
|
hum |
string |
模擬量2 |
|
recordTime |
string |
時間 |
|
tem |
string |
模擬量1 |
|
termId |
string |
節(jié)點ID |
|
alarmInfos |
array |
報警信息 |
|
alarmInfo |
string |
報警信息 |
|
analog |
string |
模擬量 |
|
state |
string |
1正常 2報警 |
表3.5.3.1
3.5.4 返回格式示例
{
"code":1000,
"message":"操作成功",
"data":{
"deviceAddr":"10000001",
"deviceName":"氣象設(shè)備001",
"deviceType":"1",
"lat":0.9999999999,
"lng":0.9999999999,
"status":"alarm",
"terms":[
{
"hum":83,
"recordTime":1620719567872,
"tem":-13.800000190734863,
"termId":1,
"alarmInfos":[
{
"alarmInfo":"斷開報警",
"analog":"1",
"state":2
}
]
}
]
}
}
3.6 獲取設(shè)備實時數(shù)據(jù) 蟲情
3.6.1接口描述
|
接口編號 |
3.6 |
|
接口名稱 |
獲取設(shè)備實時數(shù)據(jù) 蟲情 |
|
功能描述 |
獲取設(shè)備實時數(shù)據(jù) 蟲情 |
|
接口地址 |
/UserDevice/WormDeviceRealData |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表3.6.1.1
3.6.2 請求參數(shù)說明
3.6.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表3.6.2.1.1
3.6.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
表3.6.2.2.1
3.6.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
deviceAddr |
string |
設(shè)備編號 |
|
deviceType |
string |
蟲情設(shè)備標(biāo)識 蟲情：0 |
|
wormFlap |
string |
殺蟲擋板 |
|
rain |
string |
降雨狀態(tài) |
|
door |
string |
設(shè)備門狀態(tài) |
|
insecticideTem |
string |
殺蟲倉溫度 |
|
shake |
string |
震動裝置 |
|
dryingFlap |
string |
烘干擋板 |
|
lng |
string |
經(jīng)度 |
|
insecticide |
string |
殺蟲控制 |
|
moveWorm |
string |
移蟲擋板 |
|
cell |
string |
電池電量 |
|
mode |
string |
運行模式 1:NormalMode 自動 2:DebugMode 手動 |
|
drying |
string |
烘干控制 |
|
rainFlap |
string |
雨水電機(jī) |
|
DTime |
string |
系統(tǒng)時間（實時數(shù)據(jù)推送） |
|
attractWorm |
string |
誘蟲燈狀態(tài) |
|
illum |
string |
光照度 |
|
dryingTem |
string |
烘干倉溫度 |
|
lat |
string |
緯度 |
|
fillLight |
string |
補(bǔ)光燈 |
|
status |
string |
設(shè)備狀態(tài) online offline |
表3.6.3.1
3.6.4 返回格式示例
"code": 1000,
"data": {
"deviceAddr": "21022406",
"deviceType": 0,
"wormFlap": 0,
"rain": 0,
"door": 0,
"insecticideTem": 25,
"shake": 0,
"dryingFlap": 0,
"lng": 117.14513397216797,
"insecticide": 0,
"moveWorm": 0,
"cell": 100,
"mode": 2,
"drying": 0,
"rainFlap": 0,
"DTime": 1620721816,
"attractWorm": 0,
"illum": 242,
"dryingTem": 25,
"lat": 36.662166595458984,
"fillLight": 0,
"status": "online"
},
"message": "操作成功"
}
3.7 害蟲趨勢分析報告
3.7.1接口描述
|
接口編號 |
3.7 |
|
接口名稱 |
害蟲趨勢分析報告 |
|
功能描述 |
害蟲趨勢分析報告 |
|
接口地址 |
/UserDevice/getWormReportData |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表3.7.1.1
3.7.2 請求參數(shù)說明
3.7.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表3.7.2.1.1
3.7.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
beginTime |
是 |
string |
開始時間 |
|
endTime |
是 |
string |
結(jié)束時間 |
表3.7.2.2.1
3.7.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
num |
string |
數(shù)量 |
|
name |
string |
害蟲名稱 |
|
time |
string |
時間 |
表3.7.3.1
3.7.4 返回格式示例
{
"code": 1000,
"data": [
{
"num": "7",
"name": "棉鈴蟲",
"time": 1619770740000
},
{
"num": "9",
"name": "蝗蟲",
"time": 1619770740000
}
],
"message": "操作成功"
}
3.8 蟲情區(qū)域統(tǒng)計
3.8.1接口描述
|
接口編號 |
3.8 |
|
接口名稱 |
蟲情區(qū)域統(tǒng)計 |
|
功能描述 |
蟲情區(qū)域統(tǒng)計 |
|
接口地址 |
/UserDevice/getWormHistoryByGroup |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表3.8.1.1
3.8.2 請求參數(shù)說明
3.8.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表3.8.2.1.1
3.8.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
groupId |
是 |
string |
區(qū)域ID |
|
beginTime |
是 |
string |
開始時間 |
|
endTime |
是 |
string |
結(jié)束時間 |
表3.8.2.2.1
3.8.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
deviceAddr |
string |
設(shè)備地址 |
|
wornData |
array |
害蟲數(shù)據(jù) |
|
num |
string |
數(shù)量 |
|
name |
string |
害蟲名稱 |
表3.8.3.1
3.8.4 返回格式示例
{
"code": 1000,
"data": [
{
"deviceAddr": "21022405",
"wornData": [
{
"num": 9,
"name": "蝗蟲"
},
{
"num": 7,
"name": "棉鈴蟲"
}
]
}
],
"message": "操作成功"
}
3.9 害蟲自動識別
3.9.1接口描述
|
接口編號 |
3.9 |
|
接口名稱 |
害蟲自動識別 |
|
功能描述 |
害蟲自動識別 |
|
接口地址 |
/UserDevice/analysistWorm |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表3.9.1.1
3.9.2 請求參數(shù)說明
3.9.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表3.9.2.1.1
3.9.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
recordId |
是 |
string |
分析報告記錄表ID |
表3.8.2.2.1
3.9.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
表3.9.3.1
3.9.4 返回格式示例
{
"code": 1000,
"data": null,
"message": "操作成功"
}
3.9.5 備注
生成分析坐標(biāo)圖片需要5-10秒
4.0 孢子分析設(shè)備歷史記錄
4.0.1接口描述
|
接口編號 |
4.0 |
|
接口名稱 |
孢子分析設(shè)備歷史記錄 |
|
功能描述 |
孢子分析設(shè)備歷史記錄 |
|
接口地址 |
/UserDevice/getSporeAnalyzeHistoryData |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表4.0.1.1
4.0.2 請求參數(shù)說明
4.0.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表4.0.2.1.1
4.0.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
beginTime |
是 |
string |
開始時間(2021/08/13 14:00:00) |
|
endTime |
是 |
string |
結(jié)束時間(2021/09/13 14:00:00) |
表4.0.2.2.1
4.0.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
recordId |
Int |
記錄表Id |
|
deviceAddr |
string |
設(shè)備地址 |
|
value |
string |
歷史記錄數(shù)據(jù) |
|
createTime |
string |
保存時間 |
表4.0.3.1
4.0.4 返回格式示例
{
"code": 1000,
"data": [
{
"recordId": 332,
"deviceAddr": "44444444",
"value": "設(shè)備地址碼:44444444|光源狀態(tài)：關(guān)閉|采集的單次脈沖數(shù)：0|采樣口狀態(tài)：打開|控制模式：自動|對應(yīng)設(shè)備門狀態(tài)：關(guān)門|Y軸電機(jī)脈沖數(shù)：0|排氣口狀態(tài)：打開|吸氣口狀態(tài)：打開|Y軸電機(jī)狀態(tài)：停止|載玻帶電機(jī)狀態(tài)：停止|載玻帶單次運動距離的脈沖數(shù)：5",
"createTime": "2021-08-09 14:06:48"
},
{
"recordId": 331,
"deviceAddr": "44444444",
"value": "設(shè)備地址碼:44444444|光源狀態(tài)：關(guān)閉|采集的單次脈沖數(shù)：0|采樣口狀態(tài)：打開|控制模式：手動|對應(yīng)設(shè)備門狀態(tài)：關(guān)門|Y軸電機(jī)脈沖數(shù)：0|排氣口狀態(tài)：打開|吸氣口狀態(tài)：打開|Y軸電機(jī)狀態(tài)：停止|載玻帶電機(jī)狀態(tài)：停止|載玻帶單次運動距離的脈沖數(shù)：5",
"createTime": "2021-08-09 14:05:38"
}
],
"message": "操作成功"
}
4.1 孢子分析報告
4.1.1接口描述
|
接口編號 |
4.1 |
|
接口名稱 |
孢子分析報告 |
|
功能描述 |
孢子分析報告 |
|
接口地址 |
/UserDevice/getSporeAnalyzeReportData |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表4.1.1.1
4.1.2 請求參數(shù)說明
4.1.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表4.1.2.1.1
4.1.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
beginTime |
是 |
string |
開始時間(2021/08/13 14:00:00) |
|
endTime |
是 |
string |
結(jié)束時間(2021/09/13 14:00:00) |
表4.1.2.2.1
4.1.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
recordId |
Int |
記錄表Id |
|
deviceAddr |
string |
設(shè)備地址 |
|
analyst |
string |
分析員 |
|
createTime |
string |
添加時間 |
|
verifyTime |
|
分析時間 |
|
remark |
|
備注 |
|
imagesUrl |
|
拍照圖片路徑 |
|
|
|
|
表4.1.3.1
4.1.4 返回格式示例
{
"code": 1000,
"data": [
{
"recordId": 135,
"deviceAddr": "0803210101",
"analyst": null,
"createTime": "2021-08-12 14:06:05",
"verifyTime": null,
"remark": null,
"imagesUrl": "http://192.168.1.48:8085/static/sporeAnalyzerImages/0812140606599.png",
"deviceName": null
},
{
"recordId": 134,
"deviceAddr": "0803210101",
"analyst": null,
"createTime": "2021-08-12 14:03:02",
"verifyTime": null,
"remark": null,
"imagesUrl": "http://192.168.1.48:8085/static/sporeAnalyzerImages/0812140303713.png",
"deviceName": null
}
],
"message": "操作成功"
}
4.2 獲取孢子分析設(shè)備實時數(shù)據(jù)
4.2.1接口描述
|
接口編號 |
4.2 |
|
接口名稱 |
獲取孢子分析設(shè)備實時數(shù)據(jù) |
|
功能描述 |
獲取孢子分析設(shè)備實時數(shù)據(jù) |
|
接口地址 |
/UserDevice/sporeAnalyzerOverallData |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表4.2.1.1
4.2.2 請求參數(shù)說明
4.2.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表4.2.2.1.1
4.2.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
表4.2.2.2.1
4.2.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
deviceAddr |
string |
設(shè)備地址 |
|
deviceType |
string |
設(shè)備識別號 4:孢子分析設(shè)備 |
|
lng |
double |
緯度 |
|
lat |
double |
緯度 |
|
deviceName |
string |
設(shè)備名稱 |
|
status |
string |
設(shè)備狀態(tài) online offline alarming |
|
sporeAnalyzerRealData |
object |
實時數(shù)據(jù)集 |
|
controlMode |
string |
控制模式(0:手動；1：自動） |
|
ZBDMotorPulse |
string |
載玻帶單次運動距離的脈沖數(shù) |
|
BlowVentStatus |
string |
排氣口狀態(tài)（0：關(guān)閉；1：打開） |
|
IamphouseStatus |
string |
光源狀態(tài)(0:關(guān)閉；1：開啟） |
|
Latitude |
string |
設(shè)備上傳緯度 |
|
SamplingPortStatus |
string |
采樣口狀態(tài)（0：關(guān)閉；1：打開） |
|
YMotorStatus |
string |
Y軸電機(jī)狀態(tài)（0：停止；1：運行） |
|
Longitude |
string |
設(shè)備上傳經(jīng)度 |
|
AdmissionPortStatus |
string |
吸氣口狀態(tài)（0：關(guān)閉；1：打開） |
|
motorPulse |
string |
Y軸電機(jī)脈沖范圍（最小值，最大值） |
|
PulseTotal |
string |
采集的累計脈沖數(shù) |
|
YMotorPulse |
string |
Y軸電機(jī)脈沖數(shù) |
|
ZBDMotorStatus |
string |
載玻帶電機(jī)狀態(tài)（0：停止；1：運行） |
|
PulseCurrent |
string |
采集的單次脈沖數(shù) |
|
SwitchStatus |
string |
對應(yīng)設(shè)備門狀態(tài)，0代表關(guān)門/1代表開門 |
|
YMotorDirection |
string |
Y軸電機(jī)方向（0：前進(jìn)；1：后退） |
|
Altitude |
string |
海拔高度 |
|
|
|
|
表4.2.3.1
4.2.4 返回格式示例
{
"code": 1000,
"data": {
"deviceAddr": "44444444",
"deviceType": 4,
"lng": 105.3656218817,
"sporeAnalyzerRealData": {
"controlMode": "1",
"ZBDMotorPulse": "5",
"BlowVentStatus": "0",
"IamphouseStatus": "0",
"Latitude": "0",
"SamplingPortStatus": "0",
"YMotorStatus": "0",
"Longitude": "0",
"AdmissionPortStatus": "0",
"motorPulse": "0,55000",
"PulseTotal": "300",
"YMotorPulse": "0",
"ZBDMotorStatus": "0",
"PulseCurrent": "0",
"SwitchStatus": "0",
"YMotorDirection": "0",
"Altitude": "1"
},
"deviceName": "孢子設(shè)備44",
"lat": 61.3111620678,
"status": "alarm"
},
"message": "操作成功"
}
4.3 獲取灌溉設(shè)備詳情
4.3.1接口描述
|
接口編號 |
4.3 |
|
接口名稱 |
獲取灌溉設(shè)備詳情 |
|
功能描述 |
獲取灌溉設(shè)備詳情 |
|
接口地址 |
/UserDevice/getIrrigationDeviceByAddr |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表4.3.1.1
4.3.2 請求參數(shù)說明
4.3.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表4.3.2.1.1
4.3.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
factorType |
否 |
string |
1采集器 2閥門 |
|
enabled |
否 |
string |
因子使能，0,關(guān)閉；1,打開 |
表4.3.2.2.1
4.3.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
deviceAddr |
string |
蟲情設(shè)備地址碼 |
|
deviceType |
string |
設(shè)備識別號 5灌溉設(shè)備 |
|
deviceName |
string |
設(shè)備名稱 |
|
lng |
string |
經(jīng)度 |
|
lat |
string |
緯度 |
|
saveDateInterval |
string |
數(shù)據(jù)保存間隔 |
|
offlineInterval |
string |
離線判斷間隔 |
|
groupId |
string |
區(qū)域id |
|
httpUrl |
string |
攝像頭httpUrl |
|
rtmpUrl |
string |
攝像頭rtmpUrl |
|
city |
string |
城市 |
|
createTime |
string |
|
|
alertDataStatus |
string |
報警數(shù)據(jù)狀態(tài) 0關(guān)閉 1開啟 |
|
phoneOfflineNotification |
Integer |
手機(jī)離線通知狀態(tài) 0關(guān)閉 1開啟 |
|
phoneAlarmInterval |
Integer |
手機(jī)報警間隔（分鐘） |
|
phoneMaxSendingNumber |
Integer |
手機(jī)最大發(fā)送次數(shù) |
|
emailOfflineNotification |
Integer |
郵件離線通知狀態(tài) 0關(guān)閉 1開啟 |
|
emailAlarmInterval |
Integer |
郵件報警間隔（分鐘） |
|
emailMaxSendingNumber |
Integer |
郵件最大發(fā)送次數(shù) |
|
irrigationContactDOList |
List |
設(shè)備通信號碼 |
|
id |
Integer |
|
|
deviceAddr |
String |
設(shè)備編號 |
|
contactType |
Integer |
1手機(jī) 2郵箱 |
|
contact |
String |
信號碼 |
|
updateTime |
String |
更新時間 |
|
irrigationFactorDOS |
List |
灌溉因子信息 |
|
factorId |
String |
因子ID |
|
factorNo |
Integer |
因子編號 |
|
factorType |
Integer |
1采集器 2閥門 |
|
deviceAddr |
String |
設(shè)備地址 |
|
nodeType |
Integer |
無 |
|
factorName |
String |
因子名稱 |
|
enabled |
Integer |
因子使能，0,關(guān)閉；1,打開 |
|
unit |
String |
單位 |
|
digits |
Integer |
小數(shù)位數(shù) |
|
coefficient |
Float |
系數(shù) |
|
offset |
Float |
偏差 |
|
upperLimit |
Float |
上限值 |
|
lowerLimit |
Float |
下限值 |
|
electricLowerlimit |
Integer |
電量報警下限 |
|
smsEnabled |
Integer |
短信告警開關(guān)，0,關(guān)；1,開 |
|
emailEnabled |
Integer |
郵件開關(guān) |
|
offlineAlarmingSwitch |
Integer |
離線報警開關(guān) 0:關(guān) ； 1:開 |
|
offlineAlarmingAlarmContent |
String |
報警內(nèi)容模板、變量：[設(shè)備名稱][報警等級][報警值][報警范圍][設(shè)備地址][節(jié)點編號][因子名稱][系統(tǒng)時間] |
|
electricLimitSwitch |
Integer |
電量報警開關(guān) 0:關(guān) ； 1:開 |
|
electricLimitAlarmContent |
String |
報警內(nèi)容模板、變量：[設(shè)備名稱][報警等級][報警值][報警范圍][設(shè)備地址][節(jié)點編號][因子名稱][系統(tǒng)時間] |
|
excessAlarmingSwitch |
Integer |
超限報警開關(guān) 0:關(guān) ； 1:開 |
|
excessAlarmingAlarmContent |
String |
報警內(nèi)容模板、變量：[設(shè)備名稱][報警等級][報警值][報警范圍][設(shè)備地址][節(jié)點編號][因子名稱][系統(tǒng)時間] |
|
createTime |
String |
創(chuàng)建時間 |
|
|
|
|
表4.3.3.1
4.3.4 返回格式示例
{
"code":1000,
"data":{
"deviceAddr":"10000000",
"deviceType":5,
"deviceName":"測試 勿動",
"lng":230,
"lat":0,
"saveDateInterval":1,
"offlineInterval":1,
"groupId":"506dec60-a8aa-11eb-aa31-45226ea94d1e",
"httpUrl":null,
"rtmpUrl":null,
"city":null,
"createTime":"2021-08-26 16:53:20",
"alertDataStatus":"1",
"phoneOfflineNotification":1,
"phoneAlarmInterval":222,
"phoneMaxSendingNumber":0,
"emailOfflineNotification":1,
"emailAlarmInterval":111,
"emailMaxSendingNumber":44,
"groupName":null,
"terms":null,
"irrigationContactDOList":[
{
"id":572,
"deviceAddr":"10000000",
"contactType":2,
"contact":"2@qq.com",
"updateTime":"2021-09-06 13:19:16"
},
{
"id":569,
"deviceAddr":"10000000",
"contactType":1,
"contact":"18312345678",
"updateTime":"2021-09-06 13:19:16"
}
],
"irrigationFactorDOS":[
{
"factorId":"10000000_1",
"factorNo":1,
"factorType":1,
"deviceAddr":"10000000",
"nodeType":1,
"factorName":"10000000_",
"enabled":1,
"unit":"℃",
"digits":1,
"coefficient":0.1,
"offset":0,
"upperLimit":5.235,
"lowerLimit":12,
"electricLowerlimit":99,
"smsEnabled":1,
"emailEnabled":1,
"offlineAlarmingSwitch":0,
"offlineAlarmingAlarmContent":"[預(yù)警限值][設(shè)備地址]",
"electricLimitSwitch":1,
"electricLimitAlarmContent":"[報警限值][預(yù)警限值][設(shè)備地址][系統(tǒng)時間]",
"excessAlarmingSwitch":0,
"excessAlarmingAlarmContent":"[節(jié)點編號][報警限值]",
"createTime":"2021-09-06 13:20:27",
"irrigationFactorRegulatingDOList":[
]
},
{
"factorId":"10000000_86",
"factorNo":86,
"factorType":2,
"deviceAddr":"10000000",
"nodeType":3,
"factorName":"pc",
"enabled":1,
"unit":"℃",
"digits":2,
"coefficient":0.1,
"offset":1,
"upperLimit":120,
"lowerLimit":12,
"electricLowerlimit":20,
"smsEnabled":null,
"emailEnabled":null,
"offlineAlarmingSwitch":null,
"offlineAlarmingAlarmContent":null,
"electricLimitSwitch":null,
"electricLimitAlarmContent":null,
"excessAlarmingSwitch":null,
"excessAlarmingAlarmContent":null,
"createTime":"2021-09-03 15:52:05",
"irrigationFactorRegulatingDOList":[
]
}
]
},
"message":"操作成功"
}
4.4 獲取灌溉設(shè)備實時數(shù)據(jù)
4.4.1接口描述
|
接口編號 |
4.4 |
|
接口名稱 |
獲取灌溉設(shè)備實時數(shù)據(jù) |
|
功能描述 |
獲取灌溉設(shè)備實時數(shù)據(jù) |
|
接口地址 |
/UserDevice/getIrrigationDeviceOverallData |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表4.4.1.1
4.4.2 請求參數(shù)說明
4.4.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表4.4.2.1.1
4.4.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
表4.4.2.2.1
4.4.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
deviceAddr |
String |
設(shè)備地址 |
|
lng |
Double |
經(jīng)度 |
|
lat |
Double |
緯度 |
|
status |
String |
設(shè)備狀態(tài)online offline alarming |
|
deviceType |
String |
設(shè)備識別號 5灌溉設(shè)備 |
|
factors |
List |
因子實時數(shù)據(jù) |
|
electricQuantity |
String |
電量值 |
|
factorSignal |
String |
信號值 |
|
factorValue |
String |
模擬量值 |
|
alarming |
String |
是否報警 0正常 1模擬量報警 2電量報警 3同時報警 |
|
alarmingValue |
String |
報警信息 |
|
factorType |
String |
因子類型 1采集器 2閥門 |
|
factorNo |
String |
因子編號 |
|
factorId |
String |
因子id |
|
factorName |
String |
因子名稱 |
|
factorStatus |
String |
因子狀態(tài) online offline alarming |
|
factorMode |
String |
運行模式 1為手動，2為自動，3為定時-定點，4為定時-星期 5為自動-平均值 |
|
valveStatus |
String |
閥門狀態(tài) 1:打開，0:關(guān)閉 |
|
|
|
|
表4.4.3.1
4.4.4 返回格式示例
{
"code": 1000,
"data": [
{
"deviceAddr": "10000000",
"deviceType": "5",
"lng": 0.02200129584349762,
"lat": 0.008728984041221487,
"status": "online",
"factors": [
{
"electricQuantity": "0",
"factorSignal": "200",
"factorValue": "0℃",
"alarming": "0",
"alarmingValue": "10000000_越下限報警，當(dāng)前值0,下限值12.0",
"factorType": "1",
"factorNo": "1",
"factorId": "10000000_1",
"factorName": "10000000_",
"factorStatus": "offline",
"factorMode": "1",
"valveStatus": null
},
{
"electricQuantity": "100",
"factorSignal": "100",
"factorValue": null,
"alarming": "0",
"alarmingValue": null,
"factorType": "2",
"factorNo": "86",
"factorId": "10000000_86",
"factorName": "pc",
"factorStatus": "online",
"factorMode": "3",
"valveStatus": "0"
}
]
}
],
"message": "操作成功"
}
4.5 獲取灌溉設(shè)備歷史記錄
4.5.1接口描述
|
接口編號 |
4.5 |
|
接口名稱 |
獲取灌溉設(shè)備歷史記錄 |
|
功能描述 |
獲取灌溉設(shè)備歷史記錄 |
|
接口地址 |
/UserDevice/getIrrigationHistoryData |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表4.5.1.1
4.5.2 請求參數(shù)說明
4.5.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表4.5.2.1.1
4.5.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
beginTime |
是 |
string |
開始時間(2021/08/13 14:00:00) |
|
endTime |
是 |
string |
結(jié)束時間(2021/09/13 14:00:00) |
|
factorIds |
否 |
string |
因子id（多個逗號分割） |
表4.5.2.2.1
4.5.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
id |
Integer |
|
|
deviceAddr |
String |
設(shè)備地址 |
|
factorId |
String |
因子編號 |
|
factorName |
String |
名稱 |
|
createTime |
String |
創(chuàng)建時間 |
|
value |
String |
原始數(shù)據(jù) |
|
electricQuantity |
Float |
電量 |
|
signal |
Float |
信號 |
|
alarming |
Integer |
是否報警: 1為數(shù)值報警 2電量報警 3同時報警 4信號報警 |
|
valueText |
String |
展示數(shù)據(jù) |
|
|
|
|
表4.5.3.1
4.5.4 返回格式示例
{
"code": 1000,
"data": [
{
"id": 20214303,
"deviceAddr": "10000000",
"factorId": "10000000_4",
"factorName": "10000000_4",
"createTime": "2021-09-06 13:29:48",
"value": "100",
"electricQuantity": 1000,
"signal": 100,
"alarming": 0,
"valueText": null
},
{
"id": 20214293,
"deviceAddr": "10000000",
"factorId": "10000000_4",
"factorName": "10000000_4",
"createTime": "2021-09-06 13:29:32",
"value": "100",
"electricQuantity": 1000,
"signal": 100,
"alarming": 0,
"valueText": null
}
],
"message": "操作成功"
}
4.6 獲取灌溉設(shè)備操作記錄
4.6.1接口描述
|
接口編號 |
4.6 |
|
接口名稱 |
獲取灌溉設(shè)備操作記錄 |
|
功能描述 |
獲取灌溉設(shè)備操作記錄 |
|
接口地址 |
/UserDevice/getIrrigationOperationLog |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表4.6.1.1
4.6.2 請求參數(shù)說明
4.6.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表4.6.2.1.1
4.6.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
beginTime |
是 |
string |
開始時間(2021/08/13 14:00:00) |
|
endTime |
是 |
string |
結(jié)束時間(2021/09/13 14:00:00) |
|
factorIds |
否 |
string |
因子id（多個逗號分割） |
表4.6.2.2.1
4.6.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
id |
Integer |
|
|
deviceAddr |
String |
設(shè)備地址 |
|
factorId |
String |
因子編號 |
|
factorName |
String |
節(jié)點名稱 |
|
operationContent |
String |
操作內(nèi)容 |
|
operationSource |
String |
操作來源 |
|
createTime |
String |
創(chuàng)建時間 |
表4.6.3.1
4.6.4 返回格式示例
{
"code": 1000,
"data": [
{
"id": 59,
"deviceAddr": "10000000",
"factorId": "10000000_86",
"factorName": "pc",
"operationContent": "0",
"operationSource": "保持時長已到，恢復(fù)定時執(zhí)行之前閥門狀態(tài)",
"createTime": "2021-09-04 16:52:46"
},
{
"id": 58,
"deviceAddr": "10000000",
"factorId": "10000000_86",
"factorName": "pc",
"operationContent": "1",
"operationSource": "定時",
"createTime": "2021-09-04 16:50:46"
}
],
"message": "操作成功"
}
4.7 獲取灌溉設(shè)備通知記錄
4.7.1接口描述
|
接口編號 |
4.7 |
|
接口名稱 |
獲取灌溉設(shè)備通知記錄 |
|
功能描述 |
獲取灌溉設(shè)備通知記錄 |
|
接口地址 |
/UserDevice/getIrrigationNoticeRecord |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表4.7.1.1
4.7.2 請求參數(shù)說明
4.7.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表4.7.2.1.1
4.7.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
beginTime |
是 |
string |
開始時間(2021/08/13 14:00:00) |
|
endTime |
是 |
string |
結(jié)束時間(2021/09/13 14:00:00) |
|
factorIds |
否 |
string |
因子id（多個逗號分割） |
|
noticeIType |
否 |
string |
通知類型 0郵件 1短信 |
表4.7.2.2.1
4.7.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
|
noticeID |
Integer |
|
|
noticeIType |
Integer |
通知類型 0郵件 1短信 |
|
deviceAddr |
String |
設(shè)備地址 |
|
factorName |
String |
因子名稱 |
|
factorId |
String |
因子id |
|
contact |
String |
聯(lián)系人 |
|
noticeIContent |
String |
通知內(nèi)容 |
|
remark |
String |
備注 |
|
createTime |
String |
通知時間 |
表4.7.3.1
4.7.4 返回格式示例
{
"code": 1000,
"data": [
{
"noticeID": 3,
"noticeIType": 1,
"deviceAddr": "20210818",
"factorName": "雪花",
"factorId": "20210818_1",
"contact": "聯(lián)系人短信",
"noticeIContent": "通知內(nèi)容",
"remark": "備注",
"createTime": "2021-08-18 09:26:57"
},
{
"noticeID": 2,
"noticeIType": 1,
"deviceAddr": "20210818",
"factorName": "濕度",
"factorId": "20210818_1",
"contact": "聯(lián)系人短息",
"noticeIContent": "通知內(nèi)容",
"remark": "備注",
"createTime": "2021-08-18 00:00:00"
}
],
"message": "操作成功"
}
4.8 灌溉設(shè)備工作模式切換
4.8.1接口描述
|
接口編號 |
4.8 |
|
接口名稱 |
灌溉設(shè)備工作模式切換 |
|
功能描述 |
灌溉設(shè)備工作模式切換 |
|
接口地址 |
/UserDevice/modeSwitchIrrigation |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表4.8.1.1
4.8.2 請求參數(shù)說明
4.8.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表4.8.2.1.1
4.8.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
factorId |
是 |
string |
因子id(多個用逗號分割) |
|
mode |
是 |
string |
1為手動，2為自動 |
表4.8.2.2.1
4.8.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
表4.8.3.1
4.8.4 返回格式示例
{
"code": 1000,
"data": null
"message": "操作成功"
}
4.9 灌溉設(shè)備工作狀態(tài)切換
4.9.1接口描述
|
接口編號 |
4.9 |
|
接口名稱 |
灌溉設(shè)備工作狀態(tài)切換 |
|
功能描述 |
灌溉設(shè)備工作狀態(tài)切換 |
|
接口地址 |
/UserDevice/workingConditionIrrigation |
|
請求方式 |
get |
|
參數(shù)格式 |
JSON |
|
返回數(shù)據(jù)格式 |
JSON |
|
備注 |
|
表4.9.1.1
4.9.2 請求參數(shù)說明
4.9.2.1 請求頭Header參數(shù)
|
header |
必選 |
類型 |
說明 |
|
token |
是 |
string |
token |
表4.9.2.1.1
4.9.2.2 請求參數(shù)
|
字段 |
必選 |
類型 |
說明 |
|
deviceAddr |
是 |
string |
設(shè)備地址 |
|
factorId |
是 |
string |
因子id(多個用逗號分割) |
|
mode |
是 |
string |
0為關(guān)閉，1為開啟 |
表4.9.2.2.1
4.9.3 返回數(shù)據(jù)說明
|
字段 |
類型 |
說明 |
|
code |
string |
無 |
|
message |
string |
無 |
|
data |
object |
無 |
表4.9.3.1
4.9.4 返回格式示例
{
"code": 1000,
"data": null
"message": "操作成功"
}
四、附錄
返回代碼
|
代碼 |
說明 |
|
1000 |
接口執(zhí)行成功，具體參考各個接口 |
|
1001 |
接口執(zhí)行失敗，具體參考各個接口，原因參考Message |
|
1002 |
接口驗證失敗，具體參考各個接口，原因參考Message |
|
1003 |
程序內(nèi)部異常 |
|
1004 |
登錄過期 |
|
4000 |
未登錄、登陸失效 |
|
5000 |
操作失敗 |
0592-3564822
在線咨詢 9:00-18:00
排插式LoRa轉(zhuǎn)4G智能網(wǎng)關(guān)
無線遠(yuǎn)程壓力采集終端
LoRaWAN無線遠(yuǎn)程液位傳感器
無線智能消防栓水壓監(jiān)測
GNSS地質(zhì)災(zāi)害監(jiān)測站
一體化傾斜伏倒檢測儀
地表裂縫監(jiān)測儀
無線4g傾斜傳感器(內(nèi)置電池)
衛(wèi)星物聯(lián)網(wǎng)傳輸數(shù)據(jù)采集主機(jī)
智能水位控制器
智能主機(jī)環(huán)境數(shù)據(jù)4G采集儀
S-CGC5低功耗溫濕度監(jiān)控
4G噴灌滴灌流量計
土壤熱流計熱通量傳感器
有線波載64路閥門集中控制器
S-PSVF 電池供電4G無線閥門控制
水位地災(zāi)拍照雷達(dá)一體化水位
水中硼線上自動分析儀
水中鎳線上分析儀傳感器
水質(zhì)鉻自動分析儀傳感器
美麗鄉(xiāng)村水質(zhì)物聯(lián)網(wǎng)平臺
智能井蓋管理軟件平臺
S-DZJC監(jiān)測與預(yù)警服務(wù)平臺
負(fù)氧離子LED顯示發(fā)布系統(tǒng)
噪音揚塵監(jiān)測系統(tǒng)
太陽能供電電流電壓遠(yuǎn)程監(jiān)控
超聲波風(fēng)速風(fēng)向,溫濕度,噪聲
水質(zhì)離子在線傳感器
