智慧化建設(shè)項(xiàng)目綜合管理平臺(tái)接口設(shè)計(jì)規(guī)范

智慧化建設(shè)項(xiàng)目智慧管理綜合平臺(tái)接口設(shè)計(jì)規(guī)范

目錄TOC\o"1-4"\h\z\u21370智慧化建設(shè)項(xiàng)目 125702智慧管理綜合平臺(tái) 112796接口設(shè)計(jì)規(guī)范 1163481.概述 328882.接口總體要求 3325292.1.接口設(shè)計(jì)原則 3168932.2.接口安全規(guī)范 3320172.3.傳輸控制要求 4256612.4.接口業(yè)務(wù)設(shè)計(jì) 4147692.5.接口數(shù)據(jù)定義 6235123.附：平臺(tái)相關(guān)對(duì)外接口 89103.1.小鎮(zhèn)總覽 8166053.2.智慧酒店 1537943.3.智慧停車 22270643.4.智慧公廁 29182723.5.事件監(jiān)測(cè) 39279793.6.實(shí)時(shí)監(jiān)控 47248503.7.POC 50119283.8.統(tǒng)計(jì)接口 53325533.9.健康小屋 5817863.10.文件上傳接口 60

概述該文檔主要定義了智慧綜合管理平臺(tái)對(duì)外服務(wù)接口設(shè)計(jì)規(guī)范，為服務(wù)使用方和服務(wù)提供方提供開發(fā)參考。接口總體要求接口設(shè)計(jì)原則安全可靠性原則：系統(tǒng)應(yīng)提供良好的安全性和可靠性策略，支持多種安全而可靠的技術(shù)手段，制定嚴(yán)格的安全可靠的管理措施；開放性原則：提供開放式標(biāo)準(zhǔn)接口，提供與其它系統(tǒng)的互聯(lián)互通；靈活性原則：提供靈活的接口設(shè)計(jì)，便于接口的變動(dòng)；可擴(kuò)展性原則：支持新業(yè)務(wù)的擴(kuò)展以及接口容量與接口性能的提高；可管理性原則：提供良好的管理機(jī)制，保證在運(yùn)行過程中提供給管理員方便的管理方式以處理各種情況；統(tǒng)一性原則：應(yīng)當(dāng)保證系統(tǒng)的接口方式、接口形式、使用的協(xié)議等標(biāo)準(zhǔn)、統(tǒng)一。接口安全規(guī)范防sql注入例如：用戶在接口數(shù)據(jù)中輸入sql語(yǔ)句，如select*fromuserwhereuser='wang'andpsd='111111'，系統(tǒng)將拋出異常，不予執(zhí)行。防跨站腳本執(zhí)行例如腳本攻擊測(cè)試：<script>alter(1111)</script>系統(tǒng)將拋出異常，不予執(zhí)行。傳輸控制要求傳輸控制利用高速數(shù)據(jù)通道技術(shù)實(shí)現(xiàn)把前端的大數(shù)據(jù)量并發(fā)請(qǐng)求分發(fā)到后端，從而保證應(yīng)用系統(tǒng)在大量客戶端同時(shí)請(qǐng)求服務(wù)時(shí)，能夠保持快速、穩(wěn)定的工作狀態(tài)。接口業(yè)務(wù)設(shè)計(jì)充分理由不是隨便一個(gè)功能、需求就要加個(gè)接口。每新建一個(gè)接口，就要有充分的理由和考慮，即這個(gè)接口的存在是十分有意義額價(jià)值的，無(wú)意義的接口不僅增加了維護(hù)的難度，更重要是對(duì)于程序的可控性的大大降低，接口也會(huì)十分臃腫。單一職責(zé)一個(gè)接口只負(fù)責(zé)一個(gè)業(yè)務(wù)功能。高內(nèi)聚低耦合一個(gè)接口要包含完整的業(yè)務(wù)功能，而不同接口之間的業(yè)務(wù)關(guān)聯(lián)要盡可能的小。還是查詢會(huì)員的例子，有時(shí)查詢會(huì)員的同時(shí)，可能該會(huì)員的相關(guān)信息要隨之發(fā)生變化(如狀態(tài))，如果這時(shí)一條完整的業(yè)務(wù)流水線，那么就應(yīng)該在一個(gè)接口里完成，而不應(yīng)再單獨(dú)設(shè)立接口去操作完成。就是說(shuō)一個(gè)接口不應(yīng)該隨著另一個(gè)變化而變化或以某幾個(gè)接口為前提而存在。狀態(tài)及消息提供必要的接口調(diào)用狀態(tài)信息。調(diào)用是否成功如果失敗，那么失敗的原因是什么。這些必要的信息必須要告訴給客戶端。提供必要的接口調(diào)用狀態(tài)信息。調(diào)用是否成功如果失敗，那么失敗的原因是什么。這些必要的信息必須要告訴給客戶端。控制數(shù)據(jù)量一個(gè)接口返回不應(yīng)該包含過多的數(shù)據(jù)量，過多的數(shù)據(jù)量不僅處理復(fù)雜，對(duì)數(shù)據(jù)傳輸?shù)膲毫σ卜浅４?，?huì)導(dǎo)致客戶端反應(yīng)緩慢。過多的數(shù)據(jù)量很多時(shí)候都是接口劃分不明確。禁止隨意拓展參數(shù)拓展接口可能是難以避免的，但是不要隨意就加參數(shù)，加參數(shù)一定是必要且有意義的，需求改變前首先應(yīng)考慮現(xiàn)有接口內(nèi)部維護(hù)是否能滿足需求，而不要通過加個(gè)參數(shù)來(lái)方便自己實(shí)現(xiàn)需求的難度，因?yàn)閰?shù)的更變會(huì)直接導(dǎo)致客戶端調(diào)用的變化，容易產(chǎn)生版本兼容性問題。接口數(shù)據(jù)定義平臺(tái)對(duì)外接口采用基于HTTP的REST協(xié)議完成，數(shù)據(jù)傳輸默認(rèn)為JSON。例：XXXXX業(yè)務(wù)接口請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址請(qǐng)求類型Get或Post請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明weather數(shù)值當(dāng)前天氣temperature數(shù)值實(shí)時(shí)溫度humidity數(shù)值實(shí)時(shí)濕度wind數(shù)值實(shí)時(shí)風(fēng)力weatherLife數(shù)組生活指數(shù)name：生活指數(shù)名稱type：生活指數(shù)分類返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"weather":

"多云",

"temperature":

"14",

"humidity":

"69",

"weatherLife":

[

{

"date":

"2020-11-17

00:00:00",

"weather_id":

2164,

"level":

"1",

"name":

"旅游指數(shù)",

"id":

34484,

"text":

"天氣較好，溫度適宜，但風(fēng)稍微有點(diǎn)大。這樣的天氣適宜旅游，您可以盡情地享受大自然的無(wú)限風(fēng)光。",

"type":

"6",

"category":

"適宜"

}

],

"wind":

"4"

}}附：平臺(tái)相關(guān)對(duì)外接口小鎮(zhèn)總覽天氣接口模塊請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/weather請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明weather數(shù)值當(dāng)前天氣temperature數(shù)值實(shí)時(shí)溫度humidity數(shù)值實(shí)時(shí)濕度wind數(shù)值實(shí)時(shí)風(fēng)力weatherLife數(shù)組生活指數(shù)name：生活指數(shù)名稱type：生活指數(shù)分類level：生活指數(shù)等級(jí)category：生活指數(shù)等級(jí)描述text：生活指數(shù)內(nèi)容描述返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"weather":

"多云",

"temperature":

"14",

"humidity":

"69",

"weatherLife":

[

{

"date":

"2020-11-17

00:00:00",

"weather_id":

2164,

"level":

"1",

"name":

"旅游指數(shù)",

"id":

34484,

"text":

"天氣較好，溫度適宜，但風(fēng)稍微有點(diǎn)大。這樣的天氣適宜旅游，您可以盡情地享受大自然的無(wú)限風(fēng)光。",

"type":

"6",

"category":

"適宜"

}

],

"wind":

"4"

}}花卉交易額等模塊請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/composite請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明flowerMonthAmount數(shù)值當(dāng)年花卉交易總額（萬(wàn)元）flowerDayAmount數(shù)值當(dāng)月花卉交易額（暫無(wú)數(shù)據(jù)）flowerTotal數(shù)值當(dāng)年花卉交易總量（萬(wàn)枝）usedParking數(shù)值使用車位freeParking數(shù)值空余車位accountTotal數(shù)值公眾號(hào)關(guān)注總?cè)藬?shù)accountDayTotal數(shù)值公眾號(hào)當(dāng)天關(guān)注人數(shù)accountMonth數(shù)值公眾號(hào)當(dāng)月關(guān)注人數(shù)flowMonthCount數(shù)值當(dāng)月人流數(shù)faceCount數(shù)值當(dāng)天刷臉支付次數(shù)faceAmount數(shù)值當(dāng)天刷臉支付額返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"usedParking":

290,

"flowMonthCount":

186697,

"flowerMonthAmount":

278412.39,

"freeParking":

997,

"accountTotal":

102,

"flowerDayAmount":

0,

"flowerTotal":

362206.34,

"accountDayTotal":

0,

"accountMonth":

0,

"faceCount":

680,

"faceAmount":

28000

}}人流量模塊請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/peopleFlow請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明densityMax數(shù)值最高密度集densityNow數(shù)值當(dāng)前密度集densityMin數(shù)值最低密度集返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"densityMax":

55.0,

"densityNow":

47.0,

"densityMin":

46.0

}}車流量統(tǒng)計(jì)模塊請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/carFlow請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明province字符串簡(jiǎn)稱name字符串名稱count數(shù)值車輛數(shù)返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

[

{

"province":

"藏",

"count":

2,

"name":

"西藏"

},

{

"province":

"川",

"count":

154,

"name":

"四川省"

},]}智慧酒店酒店數(shù)據(jù)統(tǒng)計(jì)模塊請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址Api請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明peopleTotal數(shù)值總?cè)胱∪藬?shù)roomCount數(shù)值酒店房間數(shù)buildLand數(shù)值建筑面積salesTotal數(shù)值營(yíng)業(yè)總額profitTotal數(shù)值盈利總額usedLand數(shù)值用地面積assetsTotal數(shù)值固定資產(chǎn)總額返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"peopleTotal":

8620,

"roomCount":

50,

"buildLand":

1500.0,

"salesTotal":

230.0,

"profitTotal":

163.0,

"usedLand":

400.0,

"assetsTotal":

426.0

}}酒店今日數(shù)據(jù)模塊請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址hotelToDay請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明salesToday數(shù)值今日營(yíng)業(yè)額roomToday數(shù)值今日入住房間數(shù)emptyToday數(shù)值今日空房間數(shù)peopleToday數(shù)值今日入住數(shù)roomTodayRatio數(shù)值今日入住率emptyTodayRatio數(shù)值今日空房率返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"salesToday":

2324.0,

"roomToday":

20,

"emptyToday":

30,

"peopleToday":

20,

"roomTodayRatio":

40.0,

"emptyTodayRatio":

60.0

}}酒店近一周入住圖表請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址enterTable請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明date字符串日期oneDay數(shù)值一天入住率threeDay數(shù)值三天入住率返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

[

{

"date":

"2020-08-21",

"oneDay":

10,

"threeDay":

5

},

{

"date":

"2020-08-20",

"oneDay":

11,

"threeDay":

6

},

{

"date":

"2020-08-19",

"oneDay":

12,

"threeDay":

7

},

。。。。。。。。。

]}酒店信息列表請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/hotelInfoList請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明id數(shù)值酒店idname字符串酒店名稱type字符串酒店類型room_num字符串房間數(shù)recommendation字符串推薦度score字符串評(píng)分score_people字符串評(píng)分人數(shù)policy字符串酒店政策tel字符串聯(lián)系方式info字符串酒店信息lng字符串經(jīng)度lat字符串緯度address字符串地址img字符串酒店圖片remark字符串簡(jiǎn)介描述返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

[

{

"img":

"profile/upload/2020/10/22/42ba28b61d8540263bcf2cee82ac5685.png",

"address":

"云南省昆明市呈貢區(qū)致遠(yuǎn)路博鼎上城第七街區(qū)6棟11樓",

"score_people":

"1215",

"lng":

"102.866793",

"recommendation":

"95%",

"remark":

"該酒店位于呈貢大學(xué)城高鐵南站旁的博鼎第七街區(qū)，緊鄰云南師范大學(xué)、云南昆明理工大學(xué)等眾多高校。酒店離高鐵南站直線距離1公里，步行只需要15分鐘，車程10分鐘內(nèi)，周邊有公交車可直達(dá)雨花毓秀的公交樞紐站、地鐵站、以及其他各高校，乘坐地鐵1號(hào)線可直達(dá)花卉市場(chǎng)、螺獅灣國(guó)際商貿(mào)城、金馬碧雞坊等！房間裝修簡(jiǎn)約大氣，舒適衛(wèi)生，堅(jiān)持一客一換，問您提供舒心便捷的住宿體驗(yàn)！酒店旁有各種特色云南小吃，商場(chǎng)等，為您出行提供便利！我們誠(chéng)摯的邀請(qǐng)您入住體驗(yàn)！",

"type":

"經(jīng)濟(jì)型",

"score":

"4.4

環(huán)境

4.4

衛(wèi)生

4.6

服務(wù)

4.5

設(shè)施4.3",

"room_num":

"23",

"name":

"呈貢雅軒酒店",

"tel":

18046620203",

"id":

1,

"lat":

"24.863076",

"policy":

"入住時(shí)間:

12:00以后

離店時(shí)間:

12:00之前",

"info":

"2017年裝修2017年開業(yè)"

},

]}智慧停車停車數(shù)據(jù)總覽模塊請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/parking請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明overOne數(shù)值超過1小時(shí)的車輛數(shù)parkingTotal數(shù)值總車位數(shù)parkingUsed數(shù)值使用車位數(shù)overTwentyFour數(shù)值超過24小時(shí)的車輛數(shù)parkingEmpty數(shù)值剩余車位數(shù)todayDriveIn數(shù)值今日駛?cè)胲囕vtodayDriveOut數(shù)值今日駛出車輛返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"overOne":

170,

"parkingTotal":

1287,

"parkingUsed":

268,

"overTwentyFour":

974,

"todayDriveIn":

461,

"todayDriveOut":

176,

"parkingEmpty":

1019

}}今日全國(guó)車輛來(lái)源地統(tǒng)計(jì)請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/carFrom請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明carSource數(shù)組車流來(lái)源地Province：簡(jiǎn)稱count：車輛數(shù)name：名稱name字符串名稱count數(shù)值車輛數(shù)parkingEmpty數(shù)值空余車位數(shù)maxCarFlowNum數(shù)值年度最高車流數(shù)maxCarFlowTime字符串年度最高車流日期返回串示例"data":

{

"maxCarFlowNum":

12088,

"maxCarFlowTime":

"2020-08-25",

"carSource":

[

{

"province":

"川",

"count":

18,

"name":

"四川省"

},

{

"province":

"鄂",

"count":

10,

"name":

"湖北省"

},。。。。。。。

],

"parkingEmpty":

1047

}}今日車輛進(jìn)出數(shù)統(tǒng)計(jì)請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/carInOut請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明state字符串車輛狀態(tài)time字符串時(shí)間段count數(shù)值車輛數(shù)返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

[

{

"count":

127,

"time":

"00時(shí)",

"state":

"進(jìn)入"

},]}今日省內(nèi)車輛來(lái)源地統(tǒng)計(jì)請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/carFromYun請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明province_name字符串省名稱province字符串省簡(jiǎn)稱city_name字符串城市名稱city字符串市簡(jiǎn)稱count數(shù)值車輛數(shù)返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

[

{

"city_name":

"昆明市",

"province":

"云",

"city":

"A",

"count":

910,

"province_name":

"云南省"

},

{

"city_name":

"昭通市",

"province":

"云",

"city":

"C",

"count":

4,

"province_name":

"云南省"

},

{

"city_name":

"曲靖市",

"province":

"云",

"city":

"D",

"count":

20,

"province_name":

"云南省"

},

]}智慧公廁廁所數(shù)據(jù)統(tǒng)計(jì)模塊請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/toilet請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明total數(shù)值廁所總數(shù)malePitTotal數(shù)值男坑位總數(shù)urinalTotal數(shù)值尿斗總數(shù)femalePitTotal數(shù)值女坑位總數(shù)temperature數(shù)值溫度humidity數(shù)值濕度tvoc數(shù)值有機(jī)氣態(tài)物質(zhì)pm25數(shù)值Pm25pm1數(shù)值Pm1nh3數(shù)值氨氣濃度f(wàn)ormaldehyde數(shù)值甲醛濃度co2數(shù)值二氧化碳aqi數(shù)值空氣質(zhì)量指數(shù)pm10數(shù)值Pm10返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"tvoc":

0.5,

"pm25":

2,

"pm1":

2,

"Total":

3,

"temperature":

27.0,

"nh3":

2.0,

"aqi":

2,

"pm10":

2,

"humidity":

62.0,

"femalePitTotal":

30,

"malePitTotal":

18,

"urinalTotal":

12

}}廁所坑位使用情況請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/pitState請(qǐng)求類型Get請(qǐng)求參數(shù)字段類型說(shuō)明sn字符串非必填，廁所設(shè)備號(hào)303191212325630319121232323031912123249，不傳則默認(rèn)查詢所有廁所字段說(shuō)明字段類型說(shuō)明pitUsed數(shù)值坑位使用個(gè)數(shù)urinalUsed數(shù)值尿斗位使用個(gè)數(shù)urinalCount數(shù)值尿斗總數(shù)pitUsedRatio數(shù)值坑位使用率pitCount數(shù)值坑位個(gè)數(shù)urinalUsedRatio數(shù)值尿斗使用率male_pitCount數(shù)值男廁可服務(wù)人數(shù)male_pitUsed數(shù)值男廁已服務(wù)人數(shù)male_pitNoUsed數(shù)值男廁剩余服務(wù)人數(shù)female_pitCount數(shù)值女廁可服務(wù)人數(shù)female_pitUsed數(shù)值女廁已服務(wù)人數(shù)female_pitNoUsed數(shù)值女廁剩余服務(wù)人數(shù)temperature數(shù)值溫度humidity數(shù)值濕度tvoc數(shù)值有機(jī)氣態(tài)物質(zhì)pm25數(shù)值Pm25pm1數(shù)值Pm1nh3數(shù)值氨氣濃度f(wàn)ormaldehyde數(shù)值甲醛濃度co2數(shù)值二氧化碳aqi數(shù)值空氣質(zhì)量指數(shù)pm10數(shù)值Pm10返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"tvoc":

0,

"formaldehyde":

0,

"co2":

0,

"pm10":

0,

"pitUsed":

9,

"pitUsedRatio":

56.25,

"urinalUsedRatio":

100.0,

"pm25":

0,

"pm1":

0,

"temperature":

0,

"nh3":

0,

"aqi":

0,

"urinalUsed":

3,

"humidity":

0,

"urinalCount":

3,

"pitCount":

16

}}廁所出入流量歷史變化請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/visitHistory請(qǐng)求類型Get請(qǐng)求參數(shù)字段類型說(shuō)明sn字符串非必填，廁所設(shè)備號(hào)303191212325630319121232323031912123249，不傳則默認(rèn)查詢所有廁所ty字符串非必填，統(tǒng)計(jì)時(shí)間區(qū)間。不傳默認(rèn)為timingtiming：以分鐘為間隔hour：以小時(shí)為間隔day：以天為間隔month：以月為間隔字段說(shuō)明字段類型說(shuō)明female_in數(shù)值女廁進(jìn)流量female_stay數(shù)值女廁駐留人數(shù)female_out數(shù)值女廁出流量male_in數(shù)值男廁進(jìn)流量male_out數(shù)值男廁出流量male_stay數(shù)值男廁駐留人數(shù)sn字符串廁所設(shè)備號(hào)time字符串時(shí)間返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

[

{

"female_in":

0,

"female_stay":

1,

"male_out":

1,

"male_in":

1,

"sn":

"3031912123256",

"time":

"19:19:18",

"male_stay":

0,

"female_out":

0

},

{

"female_in":

1,

"female_stay":

1,

"male_out":

0,

"male_in":

2,

"sn":

"3031912123256",

"time":

"19:18:18",

"male_stay":

0,

"female_out":

1

},]}廁所信息列表請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/toiletInfoList請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明id數(shù)值廁所idsn字符串廁所設(shè)備號(hào)name字符串廁所名稱lng字符串經(jīng)度lat字符串緯度type字符串類型（暫時(shí)沒用）info字符串廁所描述返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

[

{

"lng":

"102.795548",

"name":

"花市游客服務(wù)中心公廁",

"id":

1,

"sn":

"3031912123256",

"type":

"ok",

"lat":

"24.909618",

"info":

"花市游客服務(wù)中心公廁"

},

{

"lng":

"102.794528",

"name":

"主場(chǎng)館2號(hào)公廁",

"id":

2,

"sn":

"3031912123232",

"type":

"ok",

"lat":

"24.908336",

"info":

"主場(chǎng)館2號(hào)公廁"

},

{

"lng":

"102.795624",

"name":

"主場(chǎng)館1號(hào)公廁",

"id":

3,

"sn":

"3031912123249",

"type":

"ok",

"lat":

"24.907946",

"info":

"主場(chǎng)館1號(hào)公廁"

}

]}事件監(jiān)測(cè)事件各分類數(shù)量請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/eventCount請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明pocCount數(shù)值Poc事件數(shù)量videoCount數(shù)值視頻監(jiān)測(cè)事件數(shù)量otherCount數(shù)值其它事件數(shù)量uvaCount數(shù)值無(wú)人機(jī)事件數(shù)量返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"pocCount":

8,

"videoCount":

6,

"otherCount":

0,

"uvaCount":

16

}}十天內(nèi)的事件數(shù)量統(tǒng)計(jì)請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址/api/sandTable/request/eventTenDays請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明date字符串日期total數(shù)值事件數(shù)量返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

[

{

"date":

"2020-08-20",

"total":

4,

},

{

"date":

"2020-08-19",

"total":

8,

},

]}事件各狀態(tài)數(shù)量統(tǒng)計(jì)請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址/api/sandTable/request/eventStatus請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明totalCount數(shù)值上報(bào)事件數(shù)量pending數(shù)值事件待處理數(shù)量processing數(shù)值事件處理中數(shù)量solved數(shù)值事件已處理數(shù)量返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"pending":

20,

"processing":

4,

"solved":

4,

"totalCount":

28

}}事件列表請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址/api/sandTable/request/eventList請(qǐng)求類型Get請(qǐng)求參數(shù)字段類型說(shuō)明pageNum數(shù)值非必填，開始頁(yè)，不傳默認(rèn)為1pageSize數(shù)值非必填，每頁(yè)大小，不傳則默認(rèn)為1000字段說(shuō)明字段類型說(shuō)明id數(shù)值事件idsource字符串事件來(lái)源level字符串事件等級(jí)status字符串處理狀態(tài)remark字符串事件描述timeStart字符串開始時(shí)間timeEnd字符串結(jié)束時(shí)間address字符串地址result字符串處理結(jié)果lng字符串經(jīng)度lat字符串緯度img字符串圖片createUser字符串上報(bào)人handleUser字符串處理人type字符串事件分類返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"total":

11,

"rows":

[

{

"searchValue":

null,

"createBy":

null,

"createTime":

null,

"updateBy":

null,

"updateTime":

null,

"remark":

null,

"dataScope":

null,

"params":

{},

"id":

7,

"source":

"POC事件",

"level":

"一般",

"status":

"處理中",

"timeStart":

"2020-09-01",

"timeEnd":

"2020-09-04",

"address":

"花卉交易市場(chǎng)3號(hào)館",

"result":

null,

"lng":

null,

"lat":

null,

"img":

"/News/UploadFiles/2017/7/10211c3b-ed9e-41dc-8131-34afa1484caa.jpg",

"createUser":

"admin",

"handleUser":

"admin",

"type":

null

}，

],

"code":

200,

"msg":

0

}}事件處理請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/updateEvent請(qǐng)求類型Get請(qǐng)求參數(shù)字段類型說(shuō)明id數(shù)值必填，事件id字段說(shuō)明字段類型說(shuō)明msg數(shù)值返回信息code字符串200為成功data字符串更新成功的條數(shù)返回串示例{

"msg":

"處理成功",

"code":

200,

"data":

1}實(shí)時(shí)監(jiān)控各設(shè)備數(shù)量統(tǒng)計(jì)請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址/api/sandTable/request/deviceCount請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明normal數(shù)值正常設(shè)備數(shù)量warn數(shù)值警告設(shè)備數(shù)量early數(shù)值預(yù)警設(shè)備數(shù)量返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"normal":

269,

"warn":

25,

"early":

15

}}視頻列表請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址Apii/sandTable/request/videoList請(qǐng)求類型Get請(qǐng)求參數(shù)字段類型說(shuō)明pageNum數(shù)值非必填，開始頁(yè)，不傳默認(rèn)為1pageSize數(shù)值非必填，每頁(yè)大小，不傳則默認(rèn)為1000字段說(shuō)明字段類型說(shuō)明id數(shù)值視頻idname字符串視頻名稱address字符串視頻流地址img字符串視頻圖片（暫時(shí)沒用）format字符串視頻格式type字符串視頻類型，1：高清直播2：園區(qū)監(jiān)控返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"total":

3,

"rows":

[

{

"searchValue":

null,

"createBy":

null,

"createTime":

null,

"updateBy":

null,

"updateTime":

null,

"remark":

null,

"dataScope":

null,

"params":

{},

"id":

1,

"name":

"",

"address":

"rtmp:///live/fGxsNC4yqoA9UUcgX96eJFidSsIz0rDVb43hBBpMiQYqbcmEQ4UfzQ4rwDVBWFeo?bizid=16847&txSecret=533f06785d99e57f5c4140a64815631a&txTime=5f8164a8",

"img":

null,

"format":

"rtmp/mp4",

"type":

"1"

},

]

}}POCpoc用戶位置列表請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址/api/sandTable/request/pocUserLocationList請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明uid數(shù)值用戶idname字符串用戶名稱phone字符串用戶電話org_name字符串所在組織名稱gps_latitude字符串除百度地圖外其它地圖坐標(biāo)系的緯度gps_longitude字符串除百度地圖外其它地圖坐標(biāo)系的經(jīng)度baidu_latitude字符串百度地圖坐標(biāo)系的緯度baidu_longitude字符串百度地圖坐標(biāo)系的經(jīng)度gaode_lng字符串高德地圖坐標(biāo)系的經(jīng)度gaode_lat字符串高德地圖坐標(biāo)系的緯度time字符串位置上報(bào)時(shí)間type字符串1：基站坐標(biāo);2：GPS坐標(biāo)speed字符串速度返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

[{

"gps_longitude":

"102.860509",

"baidu_longitude":

"102.86699284607",

"type":

"1",

"speed":

"0",

"baidu_latitude":

"24.875179808597",

"uid":

1440143147209,

"gaode_Lng":

"102.8609704",

"phone":

,

"gps_latitude":

"24.869028",

"name":

"張俊",

"gaode_Lat":

"24.8686969",

"time":

"2020-06-10

10:37:57",

"org_name":

"管委會(huì)"

},。。。。。。。。。

]}統(tǒng)計(jì)接口按月統(tǒng)計(jì)花卉交易額請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址api/sandTable/request/flowerMonth請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明volume數(shù)值交易額（萬(wàn)元）time字符串日期turnover數(shù)值交易量（萬(wàn)枝）返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

[

{

"volume":

70826,

"time":

"2020-04",

"turnover":

47715

},

{

"volume":

103693,

"time":

"2020-05",

"turnover":

72118

},

{

"volume":

77138,

"time":

"2020-06",

"turnover":

50056

}

]}按月統(tǒng)計(jì)人流請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址/api/sandTable/request/peopleFLowMonth請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明flowWeekCount數(shù)值上周人流數(shù)flowMonthCount數(shù)值當(dāng)月人流數(shù)accountTotal數(shù)值公眾號(hào)關(guān)注總?cè)藬?shù)peopleList數(shù)組按月統(tǒng)計(jì)，num:人流量time：月份返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"flowWeekCount":

80088,

"peopleList":

[

{

"num":

135018,

"time":

"2020-09"

},

{

"num":

475,

"time":

"2020-08"

}

],

"flowMonthCount":

135018,

"accountTotal":

0

}}按月統(tǒng)計(jì)車流請(qǐng)求協(xié)議http協(xié)議請(qǐng)求格式Json請(qǐng)求地址/api/sandTable/request/carFLowMonth請(qǐng)求類型Get請(qǐng)求參數(shù)無(wú)字段說(shuō)明字段類型說(shuō)明time字符串日期in_num數(shù)值進(jìn)流量數(shù)out_num數(shù)值出流量數(shù)返回串示例

{