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

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

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

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

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