This commit is contained in:
Mateusz Gruszczyński
2026-09-07 10:01:52 +02:00
parent 11da46c4d6
commit 7772e1e339
18 changed files with 347 additions and 170 deletions
+44 -3
View File
@@ -1,6 +1,6 @@
# GREE Controller API reference
HTTP and WebSocket API for GREE Controller **0.13.6**.
HTTP and WebSocket API for GREE Controller **0.13.7**.
[← Main documentation](../README.md)
@@ -231,7 +231,7 @@ Response:
{
"status": "ok",
"name": "gree-controller",
"version": "0.13.6",
"version": "0.13.7",
"uptime_seconds": 1234,
"control_ready": true,
"time": "2026-08-30T06:54:00Z"
@@ -251,13 +251,50 @@ Returns the initial Web UI snapshot:
"groups": [],
"schedules": [],
"automations": [],
"flows": [],
"access_tokens": [],
"settings": {
"application": {"simulator_enabled": false},
"gree": {
"controller_id": "gree-controller",
"poll_interval_seconds": 10,
"zone_interval_seconds": 10,
"discovery_timeout_ms": 3000,
"discovery_broadcast": "auto",
"suppress_device_beep": false,
"compressor_protection_enabled": true,
"compressor_protection_seconds": 180
},
"history": {"retention_days": 30, "compaction_enabled": true, "event_retention_days": 30},
"influxdb": {
"enabled": false, "version": "2", "url": "", "database": "gree_controller",
"username": "", "password_configured": false, "org": "", "bucket": "",
"token_configured": false, "history_threshold_days": 30
},
"notifications": {
"enabled": false, "mode": "problems", "provider": "pushover",
"pushover_configured": false, "slack_configured": false, "discord_configured": false,
"cooldown_seconds": 300, "communication_failure_threshold": 3,
"target_timeout_minutes": 60, "alert_types": {}
},
"night": {
"enabled": false, "start_time": "22:00", "end_time": "06:00",
"max_fan_speed": 1, "force_quiet": true, "use_native_sleep": true
},
"home_assistant": {
"url": "", "token_configured": false, "default_entity_id": "",
"outdoor_entity_id": "", "sensor_stale_after_seconds": 300,
"allow_invalid_tls": false, "sensor_aliases": {}, "flow_inputs": [],
"outdoor_assist_enabled": true
},
"debug": {"overlay_enabled": false, "gree_frames": false}
},
"house": {"mode": "cool"},
"outdoor_temperature": null,
"control_plan": {"generated_at": "2026-09-04T08:00:00Z", "zones": [], "rules": []},
"control_plan_revision": 42,
"system": {
"version": "0.13.6",
"version": "0.13.7",
"uptime_seconds": 1234,
"auth_required": false,
"control_ready": true,
@@ -274,6 +311,8 @@ Returns the initial Web UI snapshot:
}
```
`settings` is a single startup snapshot composed from the same response models as the eight `/api/settings/*` GET endpoints. Secret values are never included; only `*_configured` flags are exposed for stored credentials. The split settings endpoints remain the canonical resources for independent reads and updates.
### `GET /api/system/info`
Returns the `system` diagnostic object independently of the full bootstrap. Useful for monitoring and **Settings → System status**.
@@ -1472,6 +1511,8 @@ In `0.13.5`, the same disabled-zone behavior is explained directly beside the zo
In `0.13.6`, notification settings add `alert_types.sensor_discrepancy`, allowing GREE vs Home Assistant temperature-difference notifications to be disabled independently from thermostat/group control errors. The sensor fallback behavior itself is unchanged.
In `0.13.7`, the bootstrap payload also contains all eight redacted settings views. The bundled Web UI applies the same bootstrap mapper for initial HTTP load and WebSocket resynchronization, so a bootstrap frame no longer triggers eight additional settings GET requests.
Additional engine/integration events may be introduced without changing the envelope.
`api.request` data: