Wasserstand und Gerätestatus direkt aus Deinem Heimnetz.

Geräte-IP finden

Erste Anfrage

Ein einfacher HTTP-GET genügt. Ersetze die IP durch die Adresse Deines Geräts. Im Browser reicht auch die Eingabe in der Adresszeile.

curl http://192.168.1.42/status

Methode

GET

Pfad

/status

Port

80 (HTTP)

Auth

keine

Antwort & Felder

Die Antwort ist ein JSON-Objekt mit Content-Type: application/json und Cache-Control: no-store. Eine Anfrage löst keine neue Messung aus – Du bekommst den letzten bekannten Wert samt Alter.

{
  "deviceId": "drainbee",
  "firmwareVersion": "1.2.5",
  "uptimeMs": 86400000,
  "measurement": {
    "cm": 42,
    "ageMs": 3200
  },
  "wifi": {
    "isConnected": true,
    "localIp": "192.168.1.42",
    "rssiDbm": -61
  },
  "mqtt": {
    "isConnected": false
  },
  "memory": {
    "freeHeapBytes": 142000,
    "minFreeHeapBytes": 98000,
    "largestFreeBlockBytes": 86000
  }
}

Zusätzliche Felder können in späteren Firmware-Versionen hinzukommen. Verlasse Dich nicht auf die Reihenfolge der Schlüssel.

Integrationsbeispiele

Alle Beispiele lesen measurement.cm und behandeln null – vor der ersten Messung gibt es noch keinen Wert. Es sind gewöhnliche HTTP-Abfragen; eine native Drainbee-Integration, Matter oder HomeKit gibt es nicht.

sensor:
  - platform: rest
    name: "Drainbee Wasserstand"
    unique_id: drainbee_water_level
    resource: http://192.168.1.42/status
    scan_interval: 60
    timeout: 5
    unit_of_measurement: "cm"
    device_class: distance
    state_class: measurement
    availability: "{{ value_json.measurement.cm is number }}"
    value_template: "{{ value_json.measurement.cm }}"
    json_attributes_path: "$.measurement"
    json_attributes:
      - ageMs

const measurement = msg.payload?.measurement;
if (typeof measurement?.cm !== "number") {
  node.status({ fill: "grey", shape: "ring", text: "Noch keine Messung" });
  return null;
}
msg.ageMs = measurement.ageMs;
msg.payload = measurement.cm;
node.status({ fill: "blue", shape: "dot", text: measurement.cm + " cm" });
return msg;

const STATE_ID = "javascript.0.drainbee.water_level_cm";
createState(STATE_ID, null, {
  type: "number", role: "value", unit: "cm",
  read: true, write: false
}, () => {
  schedule("*/1 * * * *", () => {
    httpGet("http://192.168.1.42/status", { timeout: 5000 }, (err, response) => {
      if (err || response.statusCode !== 200) {
        setState(STATE_ID, null, true);
        log("Drainbee nicht erreichbar", "warn");
        return;
      }
      try {
        const cm = JSON.parse(response.data).measurement?.cm;
        setState(STATE_ID, typeof cm === "number" ? cm : null, true);
      } catch {
        setState(STATE_ID, null, true);
      }
    });
  });
});

import json
import urllib.error
import urllib.request

def water_level_cm(ip="192.168.1.42", timeout=5):
    with urllib.request.urlopen(f"http://{ip}/status", timeout=timeout) as response:
        data = json.load(response)
    return data["measurement"]["cm"]

try:
    cm = water_level_cm()
    print("Noch keine Messung" if cm is None else f"{cm} cm")
except (OSError, urllib.error.URLError, ValueError, KeyError) as error:
    raise SystemExit(f"Drainbee nicht erreichbar: {error}")

Fehler & Hilfe

200

OK

Status als JSON. Einzelne Felder können null sein.

404

Not Found

Unbekannter Pfad. Es gibt nur /status – andere Pfade wie /value existieren in Firmware 1.2.5 nicht.

405

Method Not Allowed

Nur GET wird unterstützt. POST, PUT und DELETE werden abgelehnt.

503

Service Unavailable

Der Status konnte gerade nicht erstellt werden. Kurz warten und erneut versuchen.

Keine Antwort? Prüfe der Reihe nach:

1. 1

   Stimmt die IP?

   Vergleiche mit Geräteeinstellungen → Lokale IP in der App oder der Geräteliste im Router. Nach einem Router-Neustart kann sie sich geändert haben – eine DHCP-Reservierung hilft.

2. 2

   Ist die Firmware aktuell?

   GET /status gibt es ab 1.2.5. Ältere Firmware antwortet nicht auf diesen Pfad. Die Version siehst Du in der App unter Geräteeinstellungen.

3. 3

   Gleiches Netz?

   Gastnetze und getrennte WLANs (z. B. IoT-VLAN) lassen oft keinen Zugriff untereinander zu. Dein Client muss im selben Netz wie Drainbee sein oder eine Route dahin haben.

4. 4

   Hat Drainbee Strom und WLAN?

   Prüfe die Stromversorgung und die Geräteliste im Router. Ohne WLAN ist die lokale API nicht erreichbar. Eine fehlende Cloud-Verbindung allein verhindert den lokalen Zugriff nicht.

5. 5

   Falsches Protokoll?

   Nutze http://, nicht https://. Manche Browser ergänzen automatisch https – tippe die Adresse mit http:// ein.

Netzwerk & Sicherheit

Die lokale API ist für Dein vertrauenswürdiges Heimnetz gedacht. Sie hat keine Authentifizierung und kein HTTPS – wer Drainbee im Netz erreichen kann, kann den Status lesen. Geändert werden kann darüber nichts.