v0.14.21

docs/API.md

@@ -1,6 +1,6 @@
 # GREE Controller API reference
 
-HTTP and WebSocket API for GREE Controller **0.14.20**.
+HTTP and WebSocket API for GREE Controller **0.14.21**.
 
 [← Main documentation](../README.md)
 
@@ -196,6 +196,7 @@ Common statuses:
 | GET/PUT | `/api/settings/gree` | GREE controller, polling, discovery and compressor settings. |
 | GET/PUT | `/api/settings/history` | Metric/event retention and compaction settings. |
 | GET/PUT | `/api/settings/influxdb` | InfluxDB history settings. |
+| POST | `/api/integrations/influxdb/test` | Test the supplied InfluxDB connection settings without saving them. |
 | GET/PUT | `/api/settings/notifications` | Notification provider and alert settings. |
 | GET/PUT | `/api/settings/night` | Night mode settings. |
 | GET/PUT | `/api/settings/home-assistant` | Home Assistant, aliases, shared Flow inputs and outdoor assist. |
@@ -239,7 +240,7 @@ Response:
 {
   "status": "ok",
   "name": "gree-controller",
-  "version": "0.14.20",
+  "version": "0.14.21",
   "uptime_seconds": 1234,
   "control_ready": true,
   "time": "2026-08-30T06:54:00Z"
@@ -302,7 +303,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.20",
+    "version": "0.14.21",
     "uptime_seconds": 1234,
     "auth_required": false,
     "control_ready": true,
@@ -1147,6 +1148,20 @@ Retention values are clamped to `1..3650` days. Updating this section immediatel
 
 `PUT` uses the same non-secret fields plus optional `password` and `token`. Omitting either field (or sending `null`) preserves the stored secret. Sending an explicit empty string clears it. `history_threshold_days` is clamped to `1..3650`; the complete InfluxDB configuration is validated before persistence.
 
+### `POST /api/integrations/influxdb/test`
+
+Accepts the same body as the InfluxDB settings update, but does not persist it. Blank/omitted secrets reuse the currently stored password/token. A successful test returns:
+
+```json
+{
+  "ok": true,
+  "version": "2",
+  "response_time_ms": 18
+}
+```
+
+InfluxDB 1.x tests a lightweight query against the configured database; InfluxDB 2.x tests a lightweight Flux query against the configured organization/bucket.
+
 ### `/api/settings/notifications`
 
 `GET` returns provider state without secret values: