智慧化建設項目綜合管理平臺接口設計規(guī)范

智慧化建設項目智慧管理綜合平臺接口設計規(guī)范

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

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

"天氣較好，溫度適宜，但風稍微有點大。這樣的天氣適宜旅游，您可以盡情地享受大自然的無限風光。",

"type":

"6",

"category":

"適宜"

}

],

"wind":

"4"

}}附：平臺相關對外接口小鎮(zhèn)總覽天氣接口模塊請求協(xié)議http協(xié)議請求格式Json請求地址api/sandTable/request/weather請求類型Get請求參數(shù)無字段說明字段類型說明weather數(shù)值當前天氣temperature數(shù)值實時溫度humidity數(shù)值實時濕度wind數(shù)值實時風力weatherLife數(shù)組生活指數(shù)name：生活指數(shù)名稱type：生活指數(shù)分類level：生活指數(shù)等級category：生活指數(shù)等級描述text：生活指數(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":

"天氣較好，溫度適宜，但風稍微有點大。這樣的天氣適宜旅游，您可以盡情地享受大自然的無限風光。",

"type":

"6",

"category":

"適宜"

}

],

"wind":

"4"

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

"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

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

"msg":

"操作成功",

"code":

200,

"data":

{

"densityMax":

55.0,

"densityNow":

47.0,

"densityMin":

46.0

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

"msg":

"操作成功",

"code":

200,

"data":

[

{

"province":

"藏",

"count":

2,

"name":

"西藏"

},

{

"province":

"川",

"count":

154,

"name":

"四川省"

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

"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ù)模塊請求協(xié)議http協(xié)議請求格式Json請求地址hotelToDay請求類型Get請求參數(shù)無字段說明字段類型說明salesToday數(shù)值今日營業(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

}}酒店近一周入住圖表請求協(xié)議http協(xié)議請求格式Json請求地址enterTable請求類型Get請求參數(shù)無字段說明字段類型說明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

},

。。。。。。。。。

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

"msg":

"操作成功",

"code":

200,

"data":

[

{

"img":

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

"address":

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

"score_people":

"1215",

"lng":

"102.866793",

"recommendation":

"95%",

"remark":

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

"type":

"經濟型",

"score":

"4.4

環(huán)境

4.4

衛(wèi)生

4.6

服務

4.5

設施4.3",

"room_num":

"23",

"name":

"呈貢雅軒酒店",

"tel":

18046620203",

"id":

1,

"lat":

"24.863076",

"policy":

"入住時間:

12:00以后

離店時間:

12:00之前",

"info":

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

},

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

"msg":

"操作成功",

"code":

200,

"data":

{

"overOne":

170,

"parkingTotal":

1287,

"parkingUsed":

268,

"overTwentyFour":

974,

"todayDriveIn":

461,

"todayDriveOut":

176,

"parkingEmpty":

1019

}}今日全國車輛來源地統(tǒng)計請求協(xié)議http協(xié)議請求格式Json請求地址api/sandTable/request/carFrom請求類型Get請求參數(shù)無字段說明字段類型說明carSource數(shù)組車流來源地Province：簡稱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

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

"msg":

"操作成功",

"code":

200,

"data":

[

{

"count":

127,

"time":

"00時",

"state":

"進入"

},]}今日省內車輛來源地統(tǒng)計請求協(xié)議http協(xié)議請求格式Json請求地址api/sandTable/request/carFromYun請求類型Get請求參數(shù)無字段說明字段類型說明province_name字符串省名稱province字符串省簡稱city_name字符串城市名稱city字符串市簡稱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)計模塊請求協(xié)議http協(xié)議請求格式Json請求地址api/sandTable/request/toilet請求類型Get請求參數(shù)無字段說明字段類型說明total數(shù)值廁所總數(shù)malePitTotal數(shù)值男坑位總數(shù)urinalTotal數(shù)值尿斗總數(shù)femalePitTotal數(shù)值女坑位總數(shù)temperature數(shù)值溫度humidity數(shù)值濕度tvoc數(shù)值有機氣態(tài)物質pm25數(shù)值Pm25pm1數(shù)值Pm1nh3數(shù)值氨氣濃度formaldehyde數(shù)值甲醛濃度co2數(shù)值二氧化碳aqi數(shù)值空氣質量指數(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

}}廁所坑位使用情況請求協(xié)議http協(xié)議請求格式Json請求地址api/sandTable/request/pitState請求類型Get請求參數(shù)字段類型說明sn字符串非必填，廁所設備號303191212325630319121232323031912123249，不傳則默認查詢所有廁所字段說明字段類型說明pitUsed數(shù)值坑位使用個數(shù)urinalUsed數(shù)值尿斗位使用個數(shù)urinalCount數(shù)值尿斗總數(shù)pitUsedRatio數(shù)值坑位使用率pitCount數(shù)值坑位個數(shù)urinalUsedRatio數(shù)值尿斗使用率male_pitCount數(shù)值男廁可服務人數(shù)male_pitUsed數(shù)值男廁已服務人數(shù)male_pitNoUsed數(shù)值男廁剩余服務人數(shù)female_pitCount數(shù)值女廁可服務人數(shù)female_pitUsed數(shù)值女廁已服務人數(shù)female_pitNoUsed數(shù)值女廁剩余服務人數(shù)temperature數(shù)值溫度humidity數(shù)值濕度tvoc數(shù)值有機氣態(tài)物質pm25數(shù)值Pm25pm1數(shù)值Pm1nh3數(shù)值氨氣濃度formaldehyde數(shù)值甲醛濃度co2數(shù)值二氧化碳aqi數(shù)值空氣質量指數(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

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

"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

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

"msg":

"操作成功",

"code":

200,

"data":

[

{

"lng":

"102.795548",

"name":

"花市游客服務中心公廁",

"id":

1,

"sn":

"3031912123256",

"type":

"ok",

"lat":

"24.909618",

"info":

"花市游客服務中心公廁"

},

{

"lng":

"102.794528",

"name":

"主場館2號公廁",

"id":

2,

"sn":

"3031912123232",

"type":

"ok",

"lat":

"24.908336",

"info":

"主場館2號公廁"

},

{

"lng":

"102.795624",

"name":

"主場館1號公廁",

"id":

3,

"sn":

"3031912123249",

"type":

"ok",

"lat":

"24.907946",

"info":

"主場館1號公廁"

}

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

"msg":

"操作成功",

"code":

200,

"data":

{

"pocCount":

8,

"videoCount":

6,

"otherCount":

0,

"uvaCount":

16

}}十天內的事件數(shù)量統(tǒng)計請求協(xié)議http協(xié)議請求格式Json請求地址/api/sandTable/request/eventTenDays請求類型Get請求參數(shù)無字段說明字段類型說明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)計請求協(xié)議http協(xié)議請求格式Json請求地址/api/sandTable/request/eventStatus請求類型Get請求參數(shù)無字段說明字段類型說明totalCount數(shù)值上報事件數(shù)量pending數(shù)值事件待處理數(shù)量processing數(shù)值事件處理中數(shù)量solved數(shù)值事件已處理數(shù)量返回串示例{

"msg":

"操作成功",

"code":

200,

"data":

{

"pending":

20,

"processing":

4,

"solved":

4,

"totalCount":

28

}}事件列表請求協(xié)議http協(xié)議請求格式Json請求地址/api/sandTable/request/eventList請求類型Get請求參數(shù)字段類型說明pageNum數(shù)值非必填，開始頁，不傳默認為1pageSize數(shù)值非必填，每頁大小，不傳則默認為1000字段說明字段類型說明id數(shù)值事件idsource字符串事件來源level字符串事件等級status字符串處理狀態(tài)remark字符串事件描述timeStart字符串開始時間timeEnd字符串結束時間address字符串地址result字符串處理結果lng字符串經度lat字符串緯度img字符串圖片createUser字符串上報人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":

"花卉交易市場3號館",

"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

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

"msg":

"處理成功",

"code":

200,

"data":

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

"msg":

"操作成功",

"code":

200,

"data":

{

"normal":

269,

"warn":

25,

"early":

15

}}視頻列表請求協(xié)議http協(xié)議請求格式Json請求地址Apii/sandTable/request/videoList請求類型Get請求參數(shù)字段類型說明pageNum數(shù)值非必填，開始頁，不傳默認為1pageSize數(shù)值非必填，每頁大小，不傳則默認為1000字段說明字段類型說明id數(shù)值視頻idname字符串視頻名稱address字符串視頻流地址img字符串視頻圖片（暫時沒用）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用戶位置列表請求協(xié)議http協(xié)議請求格式Json請求地址/api/sandTable/request/pocUserLocationList請求類型Get請求參數(shù)無字段說明字段類型說明uid數(shù)值用戶idname字符串用戶名稱phone字符串用戶電話org_name字符串所在組織名稱gps_latitude字符串除百度地圖外其它地圖坐標系的緯度gps_longitude字符串除百度地圖外其它地圖坐標系的經度baidu_latitude字符串百度地圖坐標系的緯度baidu_longitude字符串百度地圖坐標系的經度gaode_lng字符串高德地圖坐標系的經度gaode_lat字符串高德地圖坐標系的緯度time字符串位置上報時間type字符串1：基站坐標;2：GPS坐標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":

"管委會"

},。。。。。。。。。

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

"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)計人流請求協(xié)議http協(xié)議請求格式Json請求地址/api/sandTable/request/peopleFLowMonth請求類型Get請求參數(shù)無字段說明字段類型說明flowWeekCount數(shù)值上周人流數(shù)flowMonthCount數(shù)值當月人流數(shù)accountTotal數(shù)值公眾號關注總人數(shù)peopleList數(shù)組按月統(tǒng)計，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)計車流請求協(xié)議http協(xié)議請求格式Json請求地址/api/sandTable/request/carFLowMonth請求類型Get請求參數(shù)無字段說明字段類型說明time字符串日期in_num數(shù)值進流量數(shù)out_num數(shù)值出流量數(shù)返回串示例

{