惟家 JustPlus

惟家空調控制器 API（HomeKit／Matter 版）

介面說明

本 HTTP 介面僅支援控制「空調」實例。所有請求皆為在區域網路內、對裝置 IP 的 HTTP 呼叫。

介面位址

plaintext
http://<裝置IP>/api/ac

取得狀態

送出 GET 請求，回傳為陣列結構，每個空調實例是一個物件。

plaintext
GET /api/ac
json
{
  "items": [
    {
      "id": 0,
      "name": "DaiKin X50A",
      "mode": "off",
      "fan": "min",
      "swingv": "off",
      "swingh": "off",
      "temp": "25.0",
      "intemp": "25.5",
      "outtemp": "0.0",
      "fanspeed": "0",
      "status": true,
      "unit": 1
    }
  ]
}
回傳範例

欄位說明：

  • id — 空調實例編號
  • name — 機型名稱
  • mode — 目前模式
  • fan — 風速檔位
  • swingv — 上下風向擺葉
  • swingh — 左右風向擺葉
  • temp — 設定溫度
  • intemp — 室內溫度
  • outtemp — 室外溫度
  • fanspeed — 風速數值
  • status — 電源開關狀態
  • unit — 溫度單位

控制

以查詢參數帶入要設定的項目：

plaintext
GET /api/ac?{參數}={值}

可用參數與對應值：

  • mode — auto / cool / dry / heat / fan_only / off
  • fan — min / low / medium / high / max
  • swingv — on / off
  • swingh — on / off
  • temp — 16.0 ～ 30.0

範例

plaintext
http://192.168.1.100/api/ac
取得狀態
plaintext
http://192.168.1.100/api/ac?mode=cool&temp=25.0
開啟空調（冷氣 25 度）
plaintext
http://192.168.1.100/api/ac?mode=off
關閉空調

本文件為裝置在區域網路內的 HTTP 控制介面說明，需與裝置在同一網路下使用；實際欄位與行為可能隨韌體版本略有調整。

加入惟家 LINE 社群
惟家空調控制器 API（HomeKit／Matter 版） | 惟家 JustPlus