智能家居調用接口文檔


一、簡要說明
服務器地址: http://ai.home.etapi.com.cn/api/
控制器:Device

示例:
請求方式: http://ai.home.etapi.com.cn/api/Device

服務器返回數據說明
每個接口都返回下面JSON數據集合。Data數據集是多維數組,客戶端可以直接轉。

{
"State": true, --請求結果狀態 true
"Data": "[]", --服務器返回的數據
"Message": "請求完成", --消息
"Code": "0011" --狀態碼
}
二、注冊接口
名稱:Add
請求方式: POST
示例:http://ai.home.etapi.com.cn/api/Device/Add

參數名 描述
Name 設備名稱
Type 設備類型:
Light 燈
DoorLock 門
AirCondition 空調
RiceCooker 電飯煲
Curtain 窗簾
PubIP 公網IP
PrivIP 私有IP
Mac MAC地址
三、獲取設備命令
名稱:EquipmentInfo
請求方式: POST
示例:http://ai.home.etapi.com.cn/api/Device/EquipmentInfo

參數名 描述
MAC 設備的MAC地址
Type 設備類型:
Light 燈
DoorLock 門
AirCondition 空調
RiceCooker 電飯煲
Curtain 窗簾
三、設備控制
請求方式: POST

控制設備:燈
名稱:ControlDeviceLight
示例:http://ai.home.etapi.com.cn/api/Device/ControlDeviceLight

控制設備:門
名稱:ControlDeviceDoorLock
示例:http://ai.home.etapi.com.cn/api/Device/ControlDeviceDoorLock

控制設備:空調
名稱:ControlDeviceAirCondition
示例:http://ai.home.etapi.com.cn/api/Device/ControlDeviceAirCondition

控制設備:電飯煲
名稱:ControlDeviceRiceCooker
示例:http://ai.home.etapi.com.cn/api/Device/ControlDeviceRiceCooker

控制設備:窗簾
名稱:ControlDeviceCurtain
示例:http://ai.home.etapi.com.cn/api/Device/ControlDeviceCurtain

四、控制參數
所有設備的參數都必須帶有MACAddress ,其余參數則根據具體設備控制的內容改變而改變,詳細參數見“五、所有設備獲取或者控制的數據”,以下是控制燈的例子:

參數名 描述
MACAddress 設備的MAC地址
OnOff 開關,On是開啟,Off是關閉
Brightness 亮度,0-100,0是暗,100是亮
OnTime 預約每天開啟,取時分
OffTime 預約每天關閉,取時分
五、設備獲取或控制的數據
燈,返回JSON數據說明。

{
"OnOff": "On", --開關,On是開啟,Off是關閉
"Brightness": "50", --亮度,0-100,0是暗,100是亮
"OnTime": "2018-09-28 11:18:00.000", --預約每天開啟,取時分
"OffTime": "2018-09-19 20:33:00.000", --預約每天關閉,取時分
}
門,返回JSON數據說明。

{
"OnOff": "On", --開關,On是開啟,Off是關閉
"BackLocking": "On", --反鎖,On是開啟,Off是關閉
"Password": "dadad48641513", --門鎖密碼
}
空調,返回JSON數據說明。

{
"OnOff": "On", --開關,On是開啟,Off是關閉 "
Temperature": "26", --溫度,16-30度之間
"SwingFlapLevel": "On", --水平/左右掃風,On是開啟,Off是關閉
"SwingFlapVertical": "On", --垂直/上下掃風,On是開啟,Off是關閉
"AirSpeed": "Auto", --風速,Auto是自動,One是一檔,Two是二檔,Three是三檔
"Model": "Refrigeration", --模式,Refrigeration是制冷,Air是吹風,Heat是加熱
"Sleep": "On", --睡眠模式,On是開啟,Off是關閉
"Silence": "On", --靜音模式,On是開啟,Off是關閉
"OnTime": "2018-09-28 11:18:00.000", --預約每天開啟,取時分
"OffTime": "2018-09-19 20:33:00.000", --預約每天關閉,取時分
"RunTime": "2018-09-19 20:33:00.000", --預約運行多久后關閉,取時分
}
電飯煲,返回JSON數據說明。 注:Cook系列的功能同一時間只能開啟一個

{
"OnOff": "On", --開關,On是開啟,Off是關閉
"CookRice": "On", --煮飯功能,On是開啟,Off是關閉
"CookPorridge": "On", --粥/羹功能,On是開啟,Off是關閉
"CookChicken": "On", --雞/排骨功能,On是開啟,Off是關閉
"CookSteamed": "On", --蒸功能,On是開啟,Off是關閉
"CookBean": "On", --豆/蹄筋功能,On是開啟,Off是關閉
"CookSoup": "On", --煲湯功能,On是開啟,Off是關閉
"CookBabyFood": "On", --嬰兒輔食功能,On是開啟,Off是關閉
"CookCake": "On", --蛋糕功能,On是開啟,Off是關閉
"CookHeat": "On", --加熱功能,On是開啟,Off是關閉
"CookWarm": "On", --保溫功能,On是開啟,Off是關閉
"AutoWarm": "On", --自動保溫,On,Off是關閉,當Cook系列功能結束時判斷是開啟保溫
"FinishRemind ": "2018-09-28 11:18:00.000", --烹飪完成后隔多久發出提示(伴隨振鈴),取時分
"OpenWarn": "On", --烹飪未完成時開蓋發出警告,On是開啟,Off是關閉
"OpenStopHeat": "On", --烹飪未完成時開蓋停止加熱,On是開啟,Off是關閉
}
窗簾,返回JSON數據說明。

{
"OnOff": "On", --開關,On是開啟,Off是關閉
"Degree": "30", --開啟程度,0-100,0是關閉,100是打開
"OnTime": "2018-09-28 11:18:00.000", --預約每天開啟,取時分
"OffTime": "2018-09-19 20:33:00.000", --預約每天關閉,取時分
}

來源於:軟件開發


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM