管理規(guī)范-企業(yè)物流管理軟件規(guī)范說明開發(fā)文檔范本V2

PAGE37PAGE89管理規(guī)范企業(yè)物流管理軟件規(guī)范說明開發(fā)文檔范本文件編號(hào)202XQK011/BT-ZTA-QK011文件狀態(tài)[]草稿[√]正式發(fā)布[]正在修改當(dāng)前版本擬制日期審核日期日期版本變更內(nèi)容作者1.0初稿1.1修正1.2新增新產(chǎn)品功能目錄TOC\o"1-3"\h\u18544第一章公共接口 599661.1.驗(yàn)證碼發(fā)送接口 551521.2.用戶管理接口 6292371.2.1.用戶登錄驗(yàn)證接口 6265961.2.2.用戶基本信息獲取接口 951851.2.3.用戶路徑信息獲取接口 12285151.2.4.用戶電子圍欄信息獲取接口 15255971.3.設(shè)備管理接口 16164091.3.1.根據(jù)終端號(hào)查詢?cè)O(shè)備信息接口 16230991.3.2.設(shè)備默認(rèn)參數(shù)獲取接口 20112411.3.3.終端修改接口 2352021.3.4.組內(nèi)設(shè)備最近上報(bào)信息查詢接口 25188551.3.5.單個(gè)設(shè)備歷史上報(bào)信息查詢接口 2823421.3.6.新建分組接口 36272991.3.7.修改分組接口 37273771.3.8.刪除分組接口 39116911.3.9.組信息查詢接口 40175981.3.10.組內(nèi)設(shè)備信息查詢接口 4290091.3.11.查詢用戶所有終端接口 4462781.3.12..設(shè)備搜索接口 46213541.3.13..設(shè)備能力查詢接口 48110721.3.14.指定設(shè)備信息查詢接口 4916039第二章任務(wù)管理接口 51221192.1.任務(wù)參數(shù)查詢接口 51289842.2.新增任務(wù)接口 54129972.3.任務(wù)修改接口 57203702.4.任務(wù)刪除接口 60200982.5.任務(wù)列表查詢接口 6193692.6.單個(gè)任務(wù)查詢接口 64288782.7.任務(wù)設(shè)備查詢接口 6728702.8.任務(wù)內(nèi)設(shè)備最近上報(bào)信息查詢接口 69162772.9.任務(wù)開始接口 72219252.10.任務(wù)結(jié)束接口 73322.11.任務(wù)報(bào)警數(shù)據(jù)查詢 75266502.12.按月統(tǒng)計(jì)監(jiān)控賬號(hào)的任務(wù)數(shù)量 75127012.13.新增任務(wù)模板接口 77270572.14.修改任務(wù)模板接口 78309302.15.刪除模板接口 7914792.16.查詢?nèi)蝿?wù)模板列表接口 81201122.17.查詢單個(gè)任務(wù)模板信息接口 822347第三章消息相關(guān)接口 84119403.1.消息查詢接口 84168443.2.消息設(shè)置已讀接口 87131343.3.消息檢索接口 88PAGE59PAGE89公共接口驗(yàn)證碼發(fā)送接口接口功能發(fā)送短信驗(yàn)證碼。接口定義命令名稱/wlx/valicode/02/sendHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明phoneString11非空手機(jī)號(hào)typeString1非空1注冊(cè)短信2綁定短信3解綁短信4找回密碼返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.solidminuteString有效分鐘返回值類型含義String（JSON）返回驗(yàn)證碼發(fā)送結(jié)果返回值說明<樣例：發(fā)送失敗{"result":"01","description":"發(fā)送失敗"}發(fā)送成功{"result":"00","description":"發(fā)送成功","data":{"solidminute":"30"}}用戶管理接口用戶登錄驗(yàn)證接口接口功能用戶登錄驗(yàn)證接口。接口定義命令名稱/wlx/user/02/loginHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明accountString非空登錄帳號(hào)（兼容管理主賬戶和監(jiān)控賬戶）passwdString可空密碼返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString非空用戶IDdata.accountString非空登錄帳號(hào)data.phoneString非空綁定手機(jī)data.regTimeString非空注冊(cè)時(shí)間data.photoUrlString非空頭像地址data.statusString非空狀態(tài)1有效0注銷data.userTypeString非空用戶類型1管理賬戶0監(jiān)控賬號(hào)data.atString非空會(huì)話tokendata.wechatOpenIdString可空微信公眾號(hào)data.alarmTypeString非空監(jiān)控賬號(hào)登陸時(shí)有此報(bào)警類型SMS通知微信通知SMS&微信通知返回值類型含義String（JSON）返回驗(yàn)證的結(jié)果返回值說明樣例：登錄成功{ "data":{ "userType":"1", "id":"43DB07BF7E984F9B8563B4CBE9", "status":"1", "phone":"1234566", "account":"zung", "compAddr":"上海市浦東新區(qū)蔡倫路1690號(hào)", "compName":"座頭鯨（上海）信息技術(shù)有限公司", "compTel":"189d", "regTime":null, "at":"bb5d91804a702e7e7d0b3341", "photoUrl":"", "compId":"", "lastLoginTime":"2016-08-3116:14:30", "compLinkerName":"****", "compLinkerEmail":"x***ge@", "wechatOpenId":"", "compLinkerPhone":"***", "compLinkerTel":"" }, "description":"用戶驗(yàn)證成功", "result":"00"}登錄失?。簕"result":"01","description":"用戶名或密碼錯(cuò)誤"}用戶基本信息獲取接口接口功能用戶信息獲取接口。接口定義命令名稱/wlx/user/02/viewHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空用戶idatString非空用戶登錄token返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.accountString非空登錄帳號(hào)data.userTypeString非空用戶類型1管理賬戶0監(jiān)控賬號(hào)data.phoneString非空綁定手機(jī)data.regTimeString非空注冊(cè)時(shí)間data.photoUrlString非空頭像地址data.statusString非空狀態(tài)1有效0注銷data.lastLoginTimeString非空最后登錄時(shí)間pNameString可空組織名稱pAddrString可空組織地址pTelString可空組織聯(lián)系電話pLinkerNameString可空負(fù)責(zé)人姓名pLinkerTelString可空負(fù)責(zé)人電話pLinkerPhoneString可空負(fù)責(zé)人手機(jī)pLinkerEmailString可空負(fù)責(zé)人郵箱data.wechatOpenIdString可空微信公眾號(hào)data.alarmTypeString非空監(jiān)控賬號(hào)信息查詢時(shí)有此報(bào)警類型1.SMS通知2.微信通知3.SMS&微信通知返回值類型含義String（JSON）返回結(jié)果返回值說明<樣例：查詢成功{ "data":{ "userType":"1", "id":"43DB07BF7E984F9B8563B4CBE9", "status":"1", "phone":"1234566", "account":"zung", "compAddr":"上海市浦東新區(qū)蔡倫路1690號(hào)", "compName":"座頭鯨（上海）信息技術(shù)有限公司", "compTel":"189d", "regTime":null, "at":"bb5d91804a702e7e7d0b3341", "photoUrl":"", "compId":"", "lastLoginTime":"2016-08-3116:14:30", "compLinkerName":"****", "compLinkerEmail":"x***ge@", "wechatOpenId":"", "compLinkerPhone":"***", "compLinkerTel":"" }, "description":"用戶查詢成功", "result":"00"}查詢用戶信息不存在{"result":"01","description":"用戶信息不存在"}用戶路徑信息獲取接口接口功能用戶路徑信息獲取接口。接口定義命令名稱/wlx/user/02/viewpathsHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空用戶idatString非空用戶登錄token返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString非空路徑iddata.beginAddrString非空路徑開始地址data.destAddrString非空路徑目標(biāo)地址String非空路徑名稱data.routeAddrString非空路徑地址data.distanceString非空路徑距離返回值類型含義String（JSON）返回驗(yàn)證的結(jié)果返回值說明<樣例：查詢成功{ "data":[ { "name":"復(fù)旦一日游", "id":92, "routeDetail":"", "route":"121.60093,31.192188;121.503654,31.296594", "userAcc":"zuotoujing", "beginAddr":"上海市浦東新區(qū)張江高科技園區(qū)蔡倫路復(fù)旦大學(xué)張江校區(qū)", "destAddr":"上海市楊浦區(qū)五角場(chǎng)街道復(fù)旦大學(xué)復(fù)旦大學(xué)邯鄲校區(qū)", "x1":"121.60093", "y1":"31.192188", "x2":"121.503654", "y2":"31.296594"，"routeAddr":"江蘇省常州市武進(jìn)區(qū)高新區(qū)定安中路433號(hào);江蘇省無錫市宜興市徐舍鎮(zhèn)巢莊圩;江蘇省蘇州市相城區(qū)元和街道中創(chuàng)路;浙江省湖州市長(zhǎng)興縣小浦鎮(zhèn)小槐線;浙江省嘉興市秀洲區(qū)新塍鎮(zhèn)小姚弄","distance":"0;55142;112332;131172;95139" }], "description":"用戶路徑查詢成功", "result":"00"}查詢失敗{"result":"01","description":"用戶路徑查詢失敗"}用戶電子圍欄信息獲取接口接口功能用戶電子圍欄信息信息獲取接口。接口定義命令名稱/wlx/user/02/viewpoisHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空用戶idatString非空用戶登錄token返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString非空路徑iddata.addrString非空圍欄名稱data.xString非空xdata.yString非空y返回值類型含義String（JSON）返回驗(yàn)證的結(jié)果返回值說明<樣例：查詢成功{ "data":[{ "id":453, "x":"121.15404", "addr":"上海市青浦區(qū)夏陽(yáng)街道南豐路184號(hào)", "y":"31.127138", "userAcc":"zuotoujing" }], "description":"用戶圍欄查詢成功", "result":"00"}查詢失敗{"result":"01","description":"用戶圍欄查詢失敗"}設(shè)備管理接口根據(jù)終端號(hào)查詢?cè)O(shè)備信息接口A.接口功能根據(jù)終端號(hào)查詢?cè)O(shè)備信息接口。B.接口定義命令名稱/wlx/dev/02/viewHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokendevidString非空設(shè)備終端號(hào)info.curparamString可空1：同時(shí)返回監(jiān)控參數(shù)0或空：不返回監(jiān)控參數(shù)info.abilityString可空1：同時(shí)返回能力0或空：不返回能力info.curtaskString可空1：同時(shí)返回當(dāng)前任務(wù)與監(jiān)控者0或空：不返回當(dāng)前任務(wù)與監(jiān)控者info.collectorString可空1：同時(shí)返回采集設(shè)備信息0或空：不返回采集設(shè)備信息返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString32非空終端號(hào)data.adminIdString32非空用戶賬號(hào)data.phoneString可空綁定手機(jī)data.firmVersionString非空固件版本data.termVersionString非空終端版本data.devAliasString可空設(shè)備別名data.groupidString可空組Iddata.restRptCycint非空靜止上報(bào)周期data.workRptCycint非空運(yùn)行上報(bào)周期data.adminFlagString可空管理標(biāo)識(shí)data.simpleAbility可空終端能力data.task可空終端當(dāng)前任務(wù)data.monUser可空終端當(dāng)前監(jiān)控人data.param可空終端監(jiān)控信息data.collector可空終端采集設(shè)備返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{ "data":{ "id":"00A100000B468CB3", "adminFlag":"", "style":"1", "termVersion":"WLX-G-5000D-TEST", "remoteShutdown":-1, "powerStatus":"9", "enableHardShutdown":"1", "simpleAbility":["P001", "P002", "P003", "P004", "P005", "P006", "P007", "P008"], "firmVersion":"011", "adminId":"43DB07BF7E984F9B857FD00A63B4CBE9", "phone":, "devAlias":"TUOPAN3", "restRptCyc":30, "workRptCyc":5, "groupid":148, "powerUpdateTime":null }, "description":"查詢成功", "result":"00"}查詢失?。簕"result":"01","description":"設(shè)備信息不存在"}設(shè)備默認(rèn)參數(shù)獲取接口A.接口功能設(shè)備默認(rèn)參數(shù)獲取接口。B.接口定義命令名稱/wlx/dev/02/defaultparamHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話token返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.typeString非空參數(shù)類型代碼P001圍欄參數(shù)P002預(yù)設(shè)路徑參數(shù)P003溫度參數(shù)P004濕度參數(shù)P005電量參數(shù)P006光敏參數(shù)P007三軸撞擊參數(shù)P008三軸傾斜參數(shù)P009三軸顛簸參數(shù)data.startvString非空起始值若為單值參數(shù)則無結(jié)束值data.endvString可空結(jié)束值data.extvString可空擴(kuò)展值data.extv2String可空擴(kuò)展值2data.effctypeString非空?qǐng)?bào)警類型1范圍內(nèi)2范圍外3大于4小于5等于6進(jìn)出圍欄data.rptflagString非空是否報(bào)警（0不報(bào)警1報(bào)警2預(yù)警）data.typecnString非空參數(shù)中文名data.unitString可空單位data.idint非空參數(shù)Id返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{ "data":[{ "id":1, "type":"P001", "typecn":"圍欄", "unit":"", "effctype":"6", "endv":"", "extv":"1000", "extv2":"", "rptflag":"0", "startv":"" }], "description":"查詢成功", "result":"00"}終端修改接口A.接口功能終端修改接口。B.接口定義命令名稱/wlx/dev/02/updateHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokendata.idString32非空終端號(hào)data.groupidint非空組編號(hào)data.restRptCycint非空靜止上報(bào)周期data.workRptCycint非空運(yùn)行上報(bào)周期data.devAliasString非空設(shè)備別名data.adminFlagString可空管理標(biāo)識(shí)data.taskidint可空設(shè)備分配的任務(wù)iddata.enableShutdownInt非空可硬關(guān)機(jī)（0：不可，1：可，9：無此能力）data.monUser.idString可空監(jiān)控賬號(hào)iddata.param.typeString可空參數(shù)類型代碼P001圍欄參數(shù)P002預(yù)設(shè)路徑參數(shù)P003溫度參數(shù)P004濕度參數(shù)P005電量參數(shù)P006光敏參數(shù)P007三軸撞擊參數(shù)P008三軸傾斜參數(shù)P009三軸顛簸參數(shù)P010壓力參數(shù)data.param.startvString可空起始值若為單值參數(shù)則無結(jié)束值data.param.endvString可空結(jié)束值data.param.extvString可空擴(kuò)展值data.param.extv2String可空擴(kuò)展值2data.param.effctypeString可空?qǐng)?bào)警類型1范圍內(nèi)2范圍外3大于4小于5等于6進(jìn)出圍欄data.param.rptflagString可空是否報(bào)警（0不報(bào)警1報(bào)警2預(yù)警）data.param.idint可空參數(shù)Iddata.collector返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述返回值類型含義String（JSON）返回修改的結(jié)果返回值說明<樣例：修改成功{"result":"00","description":"修改成功"}組內(nèi)設(shè)備最近上報(bào)信息查詢接口A.接口功能查詢組內(nèi)設(shè)備最新上報(bào)信息接口。B.接口定義命令名稱/wlx/report/02/viewlastbygrpHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokengroupidint非空組id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString非空數(shù)據(jù)iddata.devidString非空設(shè)備iddata.typeString可空?qǐng)?bào)告類型（0普通2預(yù)警1報(bào)警）data.timeString可空?qǐng)?bào)告時(shí)間（yyyy-MM-ddHH:mm:ss）data.locxString可空經(jīng)度data.locyString可空緯度data.locnameString可空地點(diǎn)名稱data.rpts.typeString可空上報(bào)類型代碼P001圍欄參數(shù)P002預(yù)設(shè)路徑參數(shù)P003溫度參數(shù)P004濕度參數(shù)P005電量參數(shù)P006光敏參數(shù)P007三軸撞擊參數(shù)P008三軸傾斜參數(shù)P009三軸顛簸參數(shù)P010壓力參數(shù)String可空名稱（如：溫度）data.rpts.valueString可空值（如：23.5攝氏度）data.rpts.descString可空描述（如：正常）data.simpleAbilityList可空設(shè)備能力返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{"result":"00","description":"查詢成功","data":[{"id":"2342GHJGYHWGG776789HGYHGTR5T4","type":"0","time":"1.0","locx":"123.3434340","locy":"31.343423423","locname":"上海陸家嘴","rpts":[{"type":"P003","name":"溫度","value":"23.5","desc":"正常"},{"type":"P005","name":"電量","value":"40","desc":"正常"}],“simpleAbility“:[”P001”,”P002”]}]}單個(gè)設(shè)備歷史上報(bào)信息查詢接口A.接口功能單個(gè)設(shè)備歷史上報(bào)信息查詢接口，參數(shù)：設(shè)備Id，時(shí)間，天數(shù)，時(shí)間戳。B.接口定義命令名稱/wlx/report/02/viewhisHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokendevidString32非空設(shè)備iddateString非空時(shí)間：格式y(tǒng)yyyMMdddaynumint可空天數(shù)，默認(rèn)為1taskidString可空任務(wù)idtimestampeString可空格式y(tǒng)yyy-MM-ddHH:mm:sstermtypeString非空1:分體式返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述datajson數(shù)組,每個(gè)成員有如下格式:devString非空設(shè)備idlocxdouble可空火星坐標(biāo)xloxydouble可空火星坐標(biāo)ylnameString可空坐標(biāo)逆地址編碼rlocxString可空地球坐標(biāo)xrlocyString可空地球坐標(biāo)yloctint可空定位類型：1：GPS3\4:其它tidString可空任務(wù)IDspdint可空GPS速度timeString可空采集時(shí)間mListjson數(shù)組，每個(gè)元素包含一個(gè)5個(gè)長(zhǎng)度的數(shù)組，每一個(gè)單元有以下定義：0int可空ID號(hào)（安裝位置標(biāo)識(shí),0代表網(wǎng)關(guān)）1String可空參數(shù)類型代碼：P003溫度參數(shù)P004濕度參數(shù)P005電量參數(shù)P006光敏參數(shù)2String可空?qǐng)?bào)警標(biāo)志：0不報(bào)警1報(bào)警3String可空參數(shù)值4String可空參數(shù)說明返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{"data":[{"dev":"000000008087F49A","locx":0,"locy":0,"lname":"上海市閔行區(qū)浦江鎮(zhèn)上海成高機(jī)械有限公司","rlocx":0,"rlocy":0,"loct":0,"rtime":"2017-01-0919:27:25","mList":[[0,"P005","0","100","充電中"],[0,"P001","0","",""],[0,"P002","0","",""],[1,"P006","0","4","無曝光"],[1,"P004","0","71","濕度過高"],[1,"P003","0","-15.36","溫度正常"],[2,"P006","0","4","無曝光"],[2,"P004","0","71","濕度過高"],[2,"P003","0","-14.69","溫度正常"],[3,"P006","0","1","無曝光"],[3,"P004","0","67","濕度正常"],[3,"P003","0","-16.33","溫度正常"],[4,"P006","0","12","無曝光"],[4,"P004","0","77","濕度過高"],[4,"P003","0","2.82","溫度正常"],[0,"P001","0","",""]],"tid":"","spd":0,"time":"2017-01-0900:01:40"}],"description":"查詢成功","result":"00"}新建分組接口A.接口功能新建分組接口。B.接口定義命令名稱/wlx/group/02/addHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokennameString非空組名稱groupDescString可空組備注isDivisionString不可空0：便攜版1：分體版返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idint可空組id返回值類型含義String（JSON）返回執(zhí)行的結(jié)果返回值說明<樣例：增加成功{"result":"00","description":"增加成功","data":{"id":2344}}修改分組接口A.接口功能修改分組接口。B.接口定義命令名稱/wlx/group/02/updateHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokengroupidint非空組idnameString非空組名稱groupDescString可空組備注isDivisionString不可空0：便攜版1：分體版返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述返回值類型含義String（JSON）返回執(zhí)行的結(jié)果返回值說明<樣例：修改成功{"result":"00","description":"修改成功"}刪除分組接口A.接口功能刪除分組接口。B.接口定義命令名稱/wlx/group/02/delHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokengroupidint非空組id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString非空設(shè)備Iddata.devAliasString非空設(shè)備別名data.groupidString非空設(shè)備組號(hào)（新）data.adminFlagString可空管理標(biāo)識(shí)返回值類型含義String（JSON）返回執(zhí)行的結(jié)果返回值說明<樣例：刪除成功{"result":"00","description":"刪除成功"}組信息查詢接口A.接口功能組信息查詢接口。B.接口定義命令名稱/wlx/group/02/listHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokenisdivisionString非空0：便攜版1：分體版返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idint非空組String非空組名data.groupDescString可空組描述data.devNumint設(shè)備數(shù)量data.typeString1默認(rèn)，0返回值類型含義String（JSON）返回執(zhí)行的結(jié)果返回值說明<樣例：查詢成功{ "data":[{ "name":"默認(rèn)分組", "id":253, "type":"1", "isDivision":"1", "groupDesc":"默認(rèn)分組", "devNum":1 }], "result":"00", "description":"查詢成功"}組內(nèi)設(shè)備信息查詢接口A.接口功能組內(nèi)設(shè)備信息查詢接口。B.接口定義命令名稱/wlx/group/02/listdevHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokengroupidint非空組id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString非空設(shè)備iddata.devAliasString非空設(shè)備別名data.adminFlagString可空管理標(biāo)識(shí)data.remoteShutdownInt非空遠(yuǎn)程電源關(guān)閉權(quán)限

0：不可關(guān)閉1:可關(guān)閉-1：無能力返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{"result":"00","description":"查詢成功","data":[{"devid":"2342GHJGYHWGG776789HGYHGTR5T4","devAlias":"Hp設(shè)備001","adminFlag":"001"}]}查詢用戶所有終端接口A.接口功能組內(nèi)設(shè)備信息查詢接口。B.接口定義命令名稱/wlx/group/02/listgrpdevHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話token返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString非空組String非空組名data.devs.idString設(shè)備Iddata.devs.devAliasString可空設(shè)備別名返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{"result":"00","description":"查詢成功","data":[{"devid":"2342GHJGYHWGG776789HGYHGTR5T4","devAlias":"Hp設(shè)備001"}]}.設(shè)備搜索接口接口功能設(shè)備搜索接口B.接口定義命令名稱/wlx/dev/02/searchdevHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokendevAliasString非空設(shè)備別名(下個(gè)版本廢棄)termtypeString可空版本類型:便攜版（0）、分體版(1)、固定式(3)、標(biāo)簽式(4)不傳默認(rèn)為便攜版keywordString非空查詢的關(guān)鍵字typeString非空類型包括：1:ID、2：別名、3:ID或別名返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString32非空終端號(hào)data.devAliasString非空設(shè)備別名data.adminFlagString可空管理標(biāo)識(shí)data.groupidString非空組Iddata.termversionString非空終端版本返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：指令發(fā)送成功查詢成功{"result":"00","description":"查詢成功","data":{"id":"2342GHJGYHWGG776789HGYHGTR5T4","devAlias":"測(cè)試","adminFlag":"測(cè)試","groupid":"12}.設(shè)備能力查詢接口接口功能設(shè)備搜索接口B.接口定義命令名稱/wlx/ability/02/listdefaultbydevHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokenidsString非空終端設(shè)備列表,逗號(hào)相隔返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.P001.typecnString非空能力參數(shù)data.P001.typeString非空能力參數(shù)data.P001.startvString非空能力參數(shù)data.P001.endvString非空能力參數(shù)data.P001.extvString非空能力參數(shù)data.P001.extv2String非空能力參數(shù)data.P001.effectypeString非空能力參數(shù)data.P001.rptflagString非空能力參數(shù)data.P001.unitString非空能力參數(shù)….….….….….data.P010.unitString非空能力參數(shù)返回值類型含義String（JSON）返回查詢的結(jié)果指定設(shè)備信息查詢接口A.接口功能組內(nèi)設(shè)備信息查詢接口。B.接口定義命令名稱/wlx/dev/02/specificlistHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokenidsString非空多設(shè)備id，逗號(hào)連接返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString非空設(shè)備iddata.devAliasString非空設(shè)備別名data.adminFlagString可空管理標(biāo)識(shí)data.remoteShutdownInt非空遠(yuǎn)程電源關(guān)閉權(quán)限

0：不可關(guān)閉1:可關(guān)閉-1：無能力返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{"result":"00","description":"查詢成功","data":[{"devid":"2342GHJGYHWGG776789HGYHGTR5T4","devAlias":"Hp設(shè)備001","adminFlag":"001"}]}任務(wù)管理接口任務(wù)參數(shù)查詢接口A.接口功能任務(wù)參數(shù)獲取接口。B.接口定義命令名稱/wlx/task/02/defaultparamHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokentaskidint可空任務(wù)id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.restRptCycint非空靜止上報(bào)周期data.workRptCycint非空運(yùn)行上報(bào)周期data.emergencyTimeint非空緊急上送時(shí)長(zhǎng)data.param.typeString非空參數(shù)類型代碼P001圍欄參數(shù)P002預(yù)設(shè)路徑參數(shù)P003溫度參數(shù)P004濕度參數(shù)P005電量參數(shù)P006光敏參數(shù)P007三軸撞擊參數(shù)P008三軸傾斜參數(shù)P009三軸顛簸參數(shù)P010壓力參數(shù)data.param.startvString非空起始值若為單值參數(shù)則無結(jié)束值data.param.endvString可空結(jié)束值data.param.extvString可空擴(kuò)展值data.param.extv2String可空擴(kuò)展值2data.param.effctypeString非空?qǐng)?bào)警類型1范圍內(nèi)2范圍外3大于4小于5等于6進(jìn)出圍欄data.param.rptflagString非空是否報(bào)警（0不報(bào)警1報(bào)警2預(yù)警）data.param.typecnString非空參數(shù)中文名data.param.idint非空參數(shù)Id返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{"result":"00","description":"查詢成功","data":[{"type":"P002","startv":"北京","endv":"上海","extv":"121.52,31.1881;126.52,34.1881;","effctype":"1","rptflag":"0","typecn":""預(yù)設(shè)路徑","id":124},{type":"P004",startv":"5",endv":"65",extv":"",effctype":"1",rptflag":"0",typecn":"濕度","id":125}]}新增任務(wù)接口A.接口功能新增任務(wù)接口。B.接口定義命令名稱/wlx/task/02/addHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話String32非空任務(wù)名稱data.isDivisionString非空是否是分體版data.beginTimeString非空計(jì)劃開始時(shí)間（yyyy-MM-ddHH:mm:ss）data.endTimeString非空結(jié)束時(shí)間（yyyy-MM-ddHH:mm:ss）data.taskDescString非空備注data.restRptCycint非空靜止上報(bào)周期data.workRptCycint非空運(yùn)行上報(bào)周期data.emergencyTimeint非空緊急上送時(shí)長(zhǎng)data.monUser.idString可空監(jiān)控賬號(hào)iddata.param.typeString可空參數(shù)類型代碼P001圍欄參數(shù)P002預(yù)設(shè)路徑參數(shù)P003溫度參數(shù)P004濕度參數(shù)P005電量參數(shù)P006光敏參數(shù)P007三軸撞擊參數(shù)P008三軸傾斜參數(shù)P009三軸顛簸參數(shù)P010壓力參數(shù)data.param.startvString可空起始值若為單值參數(shù)則無結(jié)束值data.param.endvString可空結(jié)束值data.param.extvString可空擴(kuò)展值data.param.extv2String可空擴(kuò)展值2data.param.effctypeString可空?qǐng)?bào)警類型1范圍內(nèi)2范圍外3大于4小于5等于6進(jìn)出圍欄data.param.rptflagString可空是否報(bào)警（0不報(bào)警1報(bào)警2預(yù)警）data.param.idint可空參數(shù)Iddata.devs.idString設(shè)備Id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idint非空任務(wù)id返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：增加成功{"result":"00","description":"增加成功"}任務(wù)修改接口A.接口功能任務(wù)修改接口。B.接口定義命令名稱/wlx/task/02/updateHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokendata.idint非空任務(wù)Iddata.isDivisionString非空是否是分體版String非空終端號(hào)data.beginTimeString非空計(jì)劃開始時(shí)間（yyyy-MM-ddHH:mm:ss）data.endTimeString非空結(jié)束時(shí)間（yyyy-MM-ddHH:mm:ss）data.taskDescString非空備注data.restRptCycint非空靜止上報(bào)周期data.workRptCycint非空運(yùn)行上報(bào)周期data.emergencyTimeint非空緊急上送時(shí)長(zhǎng)data.monUser.idString可空監(jiān)控賬號(hào)data.param.typeString可空參數(shù)類型代碼P001圍欄參數(shù)P002預(yù)設(shè)路徑參數(shù)P003溫度參數(shù)P004濕度參數(shù)P005電量參數(shù)P006光敏參數(shù)P007三軸撞擊參數(shù)P008三軸傾斜參數(shù)P009三軸顛簸參數(shù)P010壓力參數(shù)data.param.startvString可空起始值若為單值參數(shù)則無結(jié)束值data.param.endvString可空結(jié)束值data.param.extvString可空擴(kuò)展值data.param.extv2String可空擴(kuò)展值2data.param.effctypeString可空?qǐng)?bào)警類型1范圍內(nèi)2范圍外3大于4小于5等于6進(jìn)出圍欄data.param.rptflagString可空是否報(bào)警（0不報(bào)警1報(bào)警2預(yù)警）data.param.idint可空參數(shù)Iddata.devs.idString設(shè)備Id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：增加成功{"result":"00","description":"增加成功"}任務(wù)刪除接口A.接口功能任務(wù)刪除接口。B.接口定義命令名稱/wlx/task/02/delHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokentaskidint非空任務(wù)Id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：刪除成功{"result":"00","description":"刪除成功"}任務(wù)列表查詢接口A.接口功能任務(wù)列表查詢接口。B.接口定義命令名稱/wlx/task/02/listHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokenisdivisionString非空是否是分體版statusString可空任務(wù)狀態(tài)（0未啟動(dòng)1執(zhí)行中2結(jié)束3強(qiáng)制結(jié)束）monthString可空查詢?cè)?，格式為YYYY-MM返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idint非空任務(wù)String32非空任務(wù)名稱data.realBeginTimeString非空計(jì)劃開始時(shí)間（yyyy-MM-ddHH:mm:ss）data.endTimeString非空結(jié)束時(shí)間（yyyy-MM-ddHH:mm:ss）data.taskDescString非空備注data.statusString非空狀態(tài)data.devNumint終端數(shù)量返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{"result":"00","description":"查詢成功","data":[{"id":123,"name":"HP任務(wù)1","realBeginTime":"2015-09-0923:23:23","endTime":"2015-09-1923:23;23","taskDesc":"HP任務(wù)1","status":"0"}]}單個(gè)任務(wù)查詢接口A.接口功能單個(gè)任務(wù)查詢接口。B.接口定義命令名稱/wlx/task/02/viewHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokentaskidint非空任務(wù)id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idint非空任務(wù)IString非空終端號(hào)data.beginTimeString非空計(jì)劃開始時(shí)間（yyyy-MM-ddHH:mm:ss）data.realBeginTimeString非空實(shí)際開始時(shí)間（yyyy-MM-ddHH:mm:ss）data.endTimeString非空結(jié)束時(shí)間（yyyy-MM-ddHH:mm:ss）data.taskDescString非空備注data.monUser.idString可空監(jiān)控賬戶data.monUser.wechatOpenIdString可空微信公眾號(hào)data.monUser.alarmTypeString非空?qǐng)?bào)警類型SMS通知微信通知SMS&微信通知data.param.endvString可空結(jié)束值data.param.extvString可空擴(kuò)展值data.param.extv2String可空擴(kuò)展值2data.param.effctypeString可空?qǐng)?bào)警類型1范圍內(nèi)2范圍外3大于4小于5等于6進(jìn)出圍欄data.param.rptflagString可空是否報(bào)警（0不報(bào)警1報(bào)警2預(yù)警）data.param.idint可空參數(shù)Iddata.groups.idString組IString組名data.groups.devs.idString設(shè)備Iddata.groups.devs.devAliasString可空設(shè)備別名data.abilityList任務(wù)終端能力返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{"result":"00","description":"查詢成功","data":{"id":234,"name":"HP任務(wù)1",……"param":[{"type":"P002","startv":"北京","endv":"上海","extv":"121.52,31.1881;126.52,34.1881;","effctype":"1","rptflag":"0","typecn":""預(yù)設(shè)路徑","id":124},{type":"P004",startv":"5",endv":"65",extv":"",effctype":"1",rptflag":"0",typecn":"濕度","id":125}]}}任務(wù)設(shè)備查詢接口A.接口功能任務(wù)設(shè)備信息查詢接口。B.接口定義命令名稱/wlx/task/02/listdevHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokentaskidint非空任務(wù)id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString非空設(shè)備iddata.devAliasString非空設(shè)備別名data.adminFlagString可空管理標(biāo)識(shí)返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{"result":"00","description":"查詢成功","data":[{"devid":"2342GHJGYHWGG776789HGYHGTR5T4","devAlias":"Hp設(shè)備001","adminFlag":"001"}]}任務(wù)內(nèi)設(shè)備最近上報(bào)信息查詢接口A.接口功能查詢組內(nèi)設(shè)備最新上報(bào)信息接口。B.接口定義命令名稱/report/02/viewbytaskHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokentaskidint非空任務(wù)id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述data.idString非空設(shè)備iddata.typeString可空?qǐng)?bào)告類型（0普通2預(yù)警1報(bào)警）data.timeString可空?qǐng)?bào)告時(shí)間data.locxString可空經(jīng)度data.locyString可空緯度data.locnameString可空地點(diǎn)名稱data.rpts.typeString可空上報(bào)類型代碼P001圍欄參數(shù)P002預(yù)設(shè)路徑參數(shù)P003溫度參數(shù)P004濕度參數(shù)P005電量參數(shù)P006光敏參數(shù)P007三軸撞擊參數(shù)P008三軸傾斜參數(shù)P009三軸顛簸參數(shù)P010壓力參數(shù)String可空名稱（如：溫度）data.rpts.valueString可空值（如：23.5攝氏度）data.rpts.descString可空描述（如：正常）返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：查詢成功{"result":"00","description":"查詢成功","data":[{"id":"2342GHJGYHWGG776789HGYHGTR5T4","type":"0","time":"1.0","locx":"123.3434340","locy":"31.343423423","locname":"上海陸家嘴","rpts":[{"type":"P003","name":"溫度","value":"23.5","desc":"正常"},{"type":"P005","name":"電量","value":"40","desc":"正常"}]}]}任務(wù)開始接口A.接口功能任務(wù)開始接口。B.接口定義命令名稱/wlx/task/02/startHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokentaskidint非空任務(wù)Id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：開啟任務(wù)成功{"result":"00","description":"開啟任務(wù)成功"}任務(wù)結(jié)束接口A.接口功能任務(wù)開始接口。B.接口定義命令名稱/wlx/task/02/stopHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokentaskidint非空任務(wù)Id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：開啟任務(wù)成功{"result":"00","description":"任務(wù)已結(jié)束"}任務(wù)報(bào)警數(shù)據(jù)查詢A.接口功能查詢主賬號(hào)下已完成的任務(wù)報(bào)警匯總數(shù)據(jù)B.接口定義命令名稱/wlx/task/02/statalarmsHttp方法Post/Get提交參數(shù)wf參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空主賬號(hào)idatString非空會(huì)話tokentaskidsString非空任務(wù)id，多個(gè)之間用逗號(hào)返回參數(shù)返回值Excel文件按月統(tǒng)計(jì)監(jiān)控賬號(hào)的任務(wù)數(shù)量A.接口功能按月統(tǒng)計(jì)監(jiān)控賬號(hào)的運(yùn)單數(shù)量B.接口定義命令名稱/wlx/task/02/monthlystattaskHttp方法Post/Get提交參數(shù)wf參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空主賬號(hào)idatString非空會(huì)話tokenisdivisionString返回參數(shù)resultString2非空返回代碼descriptionString描述data.row.monthint消息iddata.row.totalString設(shè)備編號(hào)返回值{ "data":[{ "total":1, "month":"2016-04" }], "description":"", "result":"00"}新增任務(wù)模板接口A.接口功能 新增任務(wù)模板B.接口定義命令名稱/wlx/tasktpl/02/addHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokennameString非空模板名稱contentString非空模板內(nèi)容返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述返回值類型含義String（JSON）返回查詢的結(jié)果返回值說明<樣例：{"result":"00","description":"添加成功"}修改任務(wù)模板接口A.接口功能任務(wù)模板修改接口。B.接口定義命令名稱/wlx/tasktpl/02/updateHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokentplidint非空模板idnameString非空模板名稱contentString非空模板內(nèi)容返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述返回值類型含義String（JSON）返回結(jié)果返回值說明<樣例：{"result":"00","description":"更改成功"}刪除模板接口A.接口功能刪除模板接口。B.接口定義命令名稱/wlx/tasktpl/02/deleteHttp方法Post/Get提交參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明uidString32非空操作用戶idatString非空會(huì)話tokentplidint非空模板id返回參數(shù)參數(shù)名類型長(zhǎng)度可空標(biāo)志說明resultString2非空返回代碼descriptionString非空描述返回值類型含義String（JSON）返回結(jié)果返回值說明<樣例：開啟任務(wù)成