v0.14.8

docs/API.md

@@ -1,6 +1,6 @@
 # GREE Controller API reference
 
-HTTP and WebSocket API for GREE Controller **0.14.4**.
+HTTP and WebSocket API for GREE Controller **0.14.8**.
 
 [← Main documentation](../README.md)
 
@@ -108,7 +108,8 @@ Common statuses:
 | `401 Unauthorized` | Missing/incorrect token. |
 | `404 Not Found` | Resource ID does not exist. |
 | `409 Conflict` | Revision/concurrency conflict. |
-| `502 Bad Gateway` | GREE/HA/integration communication failure. |
+| `424 Failed Dependency` | Configured external service/integration (for example Home Assistant, GREE Cloud or a notification provider) could not complete the request. |
+| `502 Bad Gateway` | Local/LAN GREE device communication failure. |
 | `500 Internal Server Error` | Unexpected server/storage error. |
 
 ## Endpoint index
@@ -232,7 +233,7 @@ Response:
 {
   "status": "ok",
   "name": "gree-controller",
-  "version": "0.14.4",
+  "version": "0.14.8",
   "uptime_seconds": 1234,
   "control_ready": true,
   "time": "2026-08-30T06:54:00Z"
@@ -295,7 +296,7 @@ Returns the initial Web UI snapshot:
   "control_plan": {"generated_at": "2026-09-04T08:00:00Z", "zones": [], "rules": []},
   "control_plan_revision": 42,
   "system": {
-    "version": "0.14.4",
+    "version": "0.14.8",
     "uptime_seconds": 1234,
     "auth_required": false,
     "control_ready": true,
@@ -1683,7 +1684,7 @@ Cloud account/discovery/diagnostic endpoints:
 
 Energy endpoints:
 
-- `GET /api/integrations/home-assistant/energy-sensors` lists compatible cumulative HA energy sensors.
+- `GET /api/integrations/home-assistant/energy-sensors` lists compatible cumulative HA energy sensors. If Home Assistant is not configured, it returns `200` with `configured: false` and an empty `sensors` array; configured dependency failures use HTTP `424`.
 - `GET /api/history/energy?device_id=...&interval=hourly|daily|weekly|monthly&source=auto|gree_cloud|home_assistant` returns consumption buckets and period summaries in kWh.
 
 Cloud settings and diagnostics are redacted: passwords, REST/MQTT tokens, Authorization values and device cipher keys are not returned.