Zum Inhalt
HALOWERK

Propwerk

hvac fault detect

Applies caller-selected thresholds to supply/return temperature differences, commanded operation, fan state and electrical power. It identifies rule violations in supplied observations only; it does not connect to building controls, establish root cause, replace commissioning or authorize maintenance actions.

POST https://prop.halowerk.com/v1/hvac-fault-detect

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
observationsarrayJa
rulesobjectJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "observations",
    "rules"
  ],
  "additionalProperties": false,
  "properties": {
    "observations": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10000,
      "items": {
        "type": "object",
        "required": [
          "observation_id",
          "mode",
          "commanded_on",
          "fan_on",
          "return_air_temperature_c",
          "supply_air_temperature_c",
          "electrical_power_kw"
        ],
        "additionalProperties": false,
        "properties": {
          "observation_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "mode": {
            "type": "string",
            "enum": [
              "cooling",
              "heating",
              "idle"
            ]
          },
          "commanded_on": {
            "type": "boolean"
          },
          "fan_on": {
            "type": "boolean"
          },
          "return_air_temperature_c": {
            "type": "number",
            "minimum": -100,
            "maximum": 100
          },
          "supply_air_temperature_c": {
            "type": "number",
            "minimum": -100,
            "maximum": 100
          },
          "electrical_power_kw": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000
          }
        }
      }
    },
    "rules": {
      "type": "object",
      "required": [
        "minimum_active_temperature_delta_c",
        "maximum_active_temperature_delta_c",
        "maximum_idle_power_kw"
      ],
      "additionalProperties": false,
      "properties": {
        "minimum_active_temperature_delta_c": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "maximum_active_temperature_delta_c": {
          "type": "number",
          "minimum": 0,
          "maximum": 200
        },
        "maximum_idle_power_kw": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000000
        }
      }
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "observations": [
    {
      "observation_id": "ahu-7-001",
      "mode": "cooling",
      "commanded_on": true,
      "fan_on": true,
      "return_air_temperature_c": 26,
      "supply_air_temperature_c": 16,
      "electrical_power_kw": 18.4
    },
    {
      "observation_id": "ahu-7-002",
      "mode": "cooling",
      "commanded_on": true,
      "fan_on": false,
      "return_air_temperature_c": 26,
      "supply_air_temperature_c": 24.5,
      "electrical_power_kw": 17.9
    }
  ],
  "rules": {
    "minimum_active_temperature_delta_c": 5,
    "maximum_active_temperature_delta_c": 20,
    "maximum_idle_power_kw": 1.2
  }
}

Ergebnis & Dokumentation

Veröffentlichtes Ergebnisschema anzeigen
{
  "$ref": "https://prop.halowerk.com/v1/hvac-fault-detect/schema#/outputSchema"
}

Veröffentlichtes Ergebnisbeispiel öffnen

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →