HA 的 REST API 實戰：用 curl 控制你家的燈

charles · 發表於 2026-9-21 08:37:50

這篇的內容（11 段）

第一步：拿一個長期權杖
第二步：確認 API 通不通
查一個實體的狀態
開燈、關燈
觸發自動化或腳本
實際用途舉三個
一：NAS 備份完成後通知
二：電腦開機時告訴 HA
三：從路由器回報網路狀態
幾個踩過的坑
安全提醒

這篇講的東西平常用不到，但只要你想從 HA 以外的地方做任何事
（腳本、NAS 的排程、另一台電腦、甚至路由器），就非它不可。

第一步：拿一個長期權杖

點左下角你的名字 → 拉到最下面「長期存取權杖」→ 建立權杖

取個名字（例如 nas-script），然後馬上複製。
那串字只會顯示一次，關掉就再也看不到了，只能刪掉重建。

權杖預設效期十年。它等同於你的帳號權限，不要貼在論壇或 GitHub 上。

第二步：確認 API 通不通

curl -s -X GET \
-H "Authorization: Bearer 你的權杖" \
-H "Content-Type: application/json" \
http://192.168.1.50:8123/api/

複製代碼

回傳這樣就對了：

{"message": "API running."}

複製代碼

以下還有約 81% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入

		自動登入	找回密碼
密碼			立即註冊

HA 的 REST API 實戰：用 curl 控制你家的燈

延伸閱讀

瀏覽過的版塊