智慧電梯數(shù)據(jù)接口規(guī)范

智慧電梯數(shù)據(jù)接口規(guī)范1.智慧電梯平臺(tái)接口定義接口類別通過(guò)統(tǒng)一Restful接口提供服務(wù)接口協(xié)議接口通信協(xié)議采用S協(xié)議請(qǐng)求類型統(tǒng)一采用POST請(qǐng)求類型請(qǐng)求數(shù)據(jù)格式請(qǐng)求數(shù)據(jù)以及響應(yīng)數(shù)據(jù)采用JSON格式1.1接口返回，統(tǒng)一數(shù)據(jù)格式參數(shù)名必選類型范圍說(shuō)明code是String接口調(diào)用返回碼。200：請(qǐng)求響應(yīng)成功…message否String成功提示或者錯(cuò)誤提示信息data否String業(yè)務(wù)響應(yīng)數(shù)據(jù)1.2智慧電梯平臺(tái)接口詳情1.2.1日常信息1.2.1.1獲取電梯基本信息服務(wù)說(shuō)明根據(jù)電梯注冊(cè)登記代碼獲取設(shè)備基礎(chǔ)信息請(qǐng)求方式POSTURL地址://{API_ROOT}/device/{registrationCode}/view

注：registrationCode:設(shè)備注冊(cè)代碼參數(shù)列表輸入?yún)?shù)參數(shù)說(shuō)明無(wú)無(wú)返回值{"data":{"factory_number":"123"，//電梯出廠編號(hào)"code_96333":""，//96333電梯識(shí)別碼"category":""，//電梯品種"lon":""，//設(shè)備所在位置經(jīng)緯度，經(jīng)度（高德地圖經(jīng)緯度）"lat":""，//設(shè)備所在位置經(jīng)緯度，緯度（高德地圖經(jīng)緯度）"equipment_number":""，//電梯型號(hào)"use_unit_name":""，//使用單位名稱"addr":""，//電梯安裝詳細(xì)地址"region":""，//所屬區(qū)域"street":""，//所屬鎮(zhèn)街"neighborhood":""，//所屬居委會(huì)"housing_estate":""，//小區(qū)/大廈"inside_number":""，//電梯內(nèi)部編號(hào)"suitable_place":""，//電梯適用場(chǎng)所"manufacturer":""，//電梯生產(chǎn)商、進(jìn)口商"production_date":""，"reforming_unit":""，//電梯改造單位"reforming_date":""，"installation_unit":""，//電梯安裝單位"installation_date":""，"maintenance_unit":""，//維護(hù)保養(yǎng)單位名稱"is_maintenance":""，//是否參與按需維保[0:否，1:是]"is_maintenance_date":""，"use_phone":""，//使用單位人員電話"maintenance_phone":""，//維保單位應(yīng)急救援電話"supervisor_name":""，//維保責(zé)任人姓名"supervisor_phone":""，//維保責(zé)任人電話"maintenance_cycle":""，//維保周期"next_inspection":""，"inspection_unit":""，//檢驗(yàn)/檢測(cè)單位"insurance_status":""，//保險(xiǎn)狀態(tài)"insurance_type":""，//保險(xiǎn)險(xiǎn)種"contractor":""，//承保單位"contractor_start":""，//承保有效期開(kāi)始日期"contractor_end":""，//承保有效期到期日期"floor_number":""，//電梯樓層數(shù)"stops_number":""，//電梯停站數(shù)"speed":""，//電梯額定速度"load_capacity":""，//電梯額定載重量"control_mode":""，//電梯控制方式"escal_speed":""，//自動(dòng)扶梯名義速度"escal_rise":""，//自動(dòng)扶梯提升高度"escal_angle":""，//自動(dòng)扶梯傾斜角"escal_width":""，//自動(dòng)扶梯名義寬度"walk_speed":""，//自動(dòng)人行道名義速度"walk_length":""，//自動(dòng)人行道使用區(qū)段長(zhǎng)度"walk_angle":""，//自動(dòng)人行道傾斜角"walk_width":""，//自動(dòng)人行道名義寬度}，"code":"200"} 1.2.1.2更新電梯基本信息服務(wù)說(shuō)明根據(jù)電梯注冊(cè)登記代碼更新電梯基本信息URL地址://{API_ROOT}/device/{registrationCode}/update

注：registrationCode:設(shè)備注冊(cè)代碼參數(shù)列表輸入?yún)?shù)參數(shù)說(shuō)明formData"factory_number":""，//電梯出廠編號(hào)（必填）"code_96333":""，//96333電梯識(shí)別碼"category":""，//電梯品種"lon":""，//設(shè)備所在位置經(jīng)緯度，經(jīng)度（高德地圖經(jīng)緯度）（必填）"lat":""，//設(shè)備所在位置經(jīng)緯度，緯度（高德地圖經(jīng)緯度）（必填）"equipment_number":""，//電梯型號(hào)"use_unit_name":""，//使用單位名稱（必填）"addr":""，//電梯安裝詳細(xì)地址"region":""，//所屬區(qū)域"street":""，//所屬鎮(zhèn)街"neighborhood":""，//所屬居委會(huì)"housing_estate":""，//小區(qū)/大廈"inside_number":""，//電梯內(nèi)部編號(hào)"suitable_place":""，//電梯適用場(chǎng)所"manufacturer":""，//電梯生產(chǎn)商、進(jìn)口商"production_date":""，//電梯出廠日期，yyyy-mm-dd"reforming_unit":""，//電梯改造單位"reforming_date":""，//電梯改造日期yyyy-mm-dd"installation_unit":""，//電梯安裝單位"installation_date":""，//電梯安裝日期yyyy-mm-dd"maintenance_unit":""，//維護(hù)保養(yǎng)單位名稱"is_maintenance":""，//是否參與按需維保[0:否，1:是]"is_maintenance_date":""，//按需維保開(kāi)始日期yyyy-mm-dd"use_phone":""，//使用單位人員電話"maintenance_phone":""，//維保單位應(yīng)急救援電話"supervisor_name":""，//維保責(zé)任人姓名"supervisor_phone":""，//維保責(zé)任人電話"maintenance_cycle":""，//維保周期"next_inspection":""，//下次檢驗(yàn)/檢測(cè)日期yyyy-mm-dd"inspection_unit":""，//檢驗(yàn)/檢測(cè)單位"insurance_status":""，//保險(xiǎn)狀態(tài)"insurance_type":""，//保險(xiǎn)險(xiǎn)種"contractor":""，//承保單位"contractor_start":""，//承保有效期開(kāi)始日期yyyy-mm-dd"contractor_end":""，//承保有效期到期日期yyyy-mm-dd"floor_number":""，//電梯樓層數(shù)"stops_number":""，//電梯停站數(shù)"speed":""，//電梯額定速度"load_capacity":""，//電梯額定載重量"control_mode":""，//電梯控制方式"escal_speed":""，//自動(dòng)扶梯名義速度"escal_rise":""，//自動(dòng)扶梯提升高度"escal_angle":""，//自動(dòng)扶梯傾斜角"escal_width":""，//自動(dòng)扶梯名義寬度"walk_speed":""，//自動(dòng)人行道名義速度"walk_length":""，//自動(dòng)人行道使用區(qū)段長(zhǎng)度"walk_angle":""，//自動(dòng)人行道傾斜角"walk_width":""，//自動(dòng)人行道名義寬度返回值{"code":"200"，"message":""}1.2.2實(shí)時(shí)數(shù)據(jù)1.2.2.1企業(yè)平臺(tái)在線狀態(tài)監(jiān)測(cè)（心跳）實(shí)時(shí)指令采集時(shí)序圖服務(wù)說(shuō)明定期輪詢調(diào)用，用于監(jiān)測(cè)各企業(yè)平臺(tái)在線狀態(tài)通過(guò)此接口企業(yè)平臺(tái)實(shí)時(shí)接收智慧電梯平臺(tái)下達(dá)的指令URL地址://{API_ROOT}/node/active返回值示例{"code":"200"，"message":""，"data":{"cmds":[{"cmdid":"1233333125"，//指令標(biāo)識(shí)符"code":"C0"，//上傳指定時(shí)間段維保記錄信息"registrationCodes":'sdhf412313，…'，"start":"2020.07.01"，"end":"2020.09.01"}]}}指令明細(xì)規(guī)范指令代碼描述C0上傳指定設(shè)備的指定時(shí)間段（yyyy-mm-dd）維保記錄1.2.2.1.1回溯上傳維保記錄（指令C0）服務(wù)說(shuō)明收到智慧電梯平臺(tái)的C0指令后，開(kāi)始上傳設(shè)備對(duì)應(yīng)時(shí)間段的維保記錄數(shù)據(jù)

注：一次可上傳多條（不超過(guò)20條）維保記錄信息URL://{API_ROOT}/cmd/{cmdid}/record注：cmdid指令標(biāo)識(shí)符參數(shù)列表參數(shù)名稱參數(shù)說(shuō)明formData[{"registrationCode":"code123"http://設(shè)備注冊(cè)代碼（必填）"unit":""，//使用單位名稱（必填）"safety_manager":""，//安全管理人員（必填）"safety_manager_phone":""，//安全管理人員電話（必填）"inner_code":""，//單位內(nèi)編號(hào)（必填）"emergency_phone":""，//緊急聯(lián)系電話（必填）"contractor":""，//維保公司名稱（必填）"name1":""，//維保作業(yè)人姓名（必填）"phone1":""，//維保人作業(yè)人電話（必填）"name2":""，//維保作業(yè)人2姓名"phone2":""，//維保人作業(yè)人2電話"start_time":""，//維保開(kāi)始時(shí)間yyyy-mm-ddhh24:mi（必填）"end_time":""，//維保結(jié)束時(shí)間yyyy-mm-ddhh24:mi（必填）"mc_type":""，//維保類型[0:半月，1：季度，2：半年，3：年度，4：按需維保]（必填）"recorder":""，//記錄填寫(xiě)人姓名（必填）"recorder_phone":""，//記錄填寫(xiě)人電話（必填）"record_time":""，//記錄填寫(xiě)時(shí)間yyyy-mm-ddhh24:mi（必填）"record_type":"0"，//記錄歸集方式（0：接口調(diào)用，1：手動(dòng)錄入）（必填）"record_id":""，//原始記錄ID（本地主鍵）（必填）}，…]返回值{"code":"200"，"message":""}1.2.2.1.4回溯上傳維保附件（指令C0）服務(wù)說(shuō)明上傳維保記錄對(duì)應(yīng)的附件數(shù)據(jù)URL://{API_ROOT}/cmd/{cmdid}/file注：cmdid指令標(biāo)識(shí)符參數(shù)列表參數(shù)名稱參數(shù)說(shuō)明file上傳文件的文件流（必填），大小不得超過(guò)20M，后綴為png，jpg，jpeg;record_id本地維保記錄ID（主鍵）（必填）返回值{"code":"200"，"message":""}1.2.2.1.5指令完結(jié)服務(wù)說(shuō)明執(zhí)行完指定指令后，調(diào)用此接口終止完成該指令。URL://{API_ROOT}/cmd/{cmdid}/stop參數(shù)列表參數(shù)名稱參數(shù)說(shuō)明無(wú)無(wú)返回值{"code":"200"，