💧 智慧水閥控制系統

🔌 完整 API 文檔

🔐 認證

所有控制類 API 都需要有效的 API 金鑰。支援三種認證方式：

?key=YOUR_API_KEY 或 X-API-Key: YOUR_API_KEY 或 Authorization: Bearer YOUR_API_KEY

💧 基本水閥控制

開啟水閥: GET /api/open?key=KEY&duration=60

關閉水閥: GET /api/close?key=KEY

查詢狀態: GET /api/status (免認證)

💧 澆水控制 (簡化版)

開始澆水: POST /api/water/start

參數: duration (30-600秒), device_id (可選)

停止澆水: POST /api/water/stop

🔧 設備管理

設備列表: GET /api/devices?key=KEY

設備狀態: GET /api/devices/DEVICE_ID/status?key=KEY

控制設備: POST /api/devices/DEVICE_ID/control

參數: action (open/close/stop), duration (可選)

👥 用戶管理 (需超級管理員)

用戶列表: GET /api/users?key=KEY&admin_id=ADMIN_ID

設定角色: PUT /api/users/USER_ID/role

參數: role (admin/operator/viewer/none), name (可選)

📊 系統資訊

系統資訊: GET /api/system/info?key=KEY

重連 MQTT: POST /api/mqtt/reconnect?key=KEY

🧪 測試指令

curl "https://water-value.qcair.net/api/status"

curl -H "X-API-Key: qcair_api_key_2025" "https://water-value.qcair.net/api/devices"

curl -X POST -H "X-API-Key: qcair_api_key_2025" -H "Content-Type: application/json" -d 'duration ' "https://water-value.qcair.net/api/water/start"