Vandstand og enhedsstatus direkte fra dit hjemmenetværk.

Find enhedens IP

Første forespørgsel

Et enkelt HTTP GET-kald er nok. Erstat IP-adressen med din enheds adresse. Du kan også skrive den direkte i browserens adresselinje.

curl http://192.168.1.42/status

Metode

GET

Sti

/status

Port

80 (HTTP)

Godkendelse

ingen

Svar og felter

Svaret er et JSON-objekt med Content-Type: application/json og Cache-Control: no-store. En forespørgsel starter ikke en ny måling – du får den senest kendte værdi og dens alder.

{
  "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
  }
}

Senere firmwareversioner kan tilføje felter. Regn ikke med en bestemt rækkefølge af nøglerne.

Integrationseksempler

Alle eksempler læser measurement.cm og håndterer null – før den første måling er der ingen værdi. Det er almindelige HTTP-kald; der er ingen indbygget Drainbee-integration og ingen understøttelse af Matter eller HomeKit.

sensor:
  - platform: rest
    name: "Drainbee vandstand"
    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: "Ingen måling endnu" });
  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 kan ikke nås", "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("Ingen måling endnu" if cm is None else f"{cm} cm")
except (OSError, urllib.error.URLError, ValueError, KeyError) as error:
    raise SystemExit(f"Drainbee kan ikke nås: {error}")

Fejl og hjælp

200

OK

Status som JSON. Enkelte felter kan være null.

404

Not Found

Ukendt sti. Kun /status findes – stier som /value er ikke tilgængelige i firmware 1.2.5.

405

Method Not Allowed

Kun GET understøttes. POST, PUT og DELETE afvises.

503

Service Unavailable

Status kunne ikke oprettes lige nu. Vent lidt, og prøv igen.

Intet svar? Tjek i denne rækkefølge:

1. 1

   Er IP-adressen korrekt?

   Sammenlign med Enhedsindstillinger → Lokal IP i appen eller routerens enhedsliste. Adressen kan ændre sig efter en genstart af routeren – en DHCP-reservation hjælper.

2. 2

   Er firmwaren opdateret?

   GET /status findes fra 1.2.5. Ældre firmware svarer ikke på denne sti. Se versionen i appens enhedsindstillinger.

3. 3

   Samme netværk?

   Gæstenetværk og separate Wi-Fi-net, f.eks. et IoT-VLAN, blokerer ofte adgangen mellem enheder. Din klient skal være på samme netværk som Drainbee eller have en rute til det.

4. 4

   Har Drainbee strøm og Wi-Fi?

   Tjek strømforsyningen og routerens enhedsliste. Det lokale API kræver Wi-Fi. En manglende skyforbindelse alene forhindrer ikke lokal adgang.

5. 5

   Forkert protokol?

   Brug http://, ikke https://. Nogle browsere tilføjer https automatisk – skriv adressen med http://.

Netværk og sikkerhed

Det lokale API er beregnet til dit betroede hjemmenetværk. Det har ingen godkendelse eller HTTPS. Alle, der kan nå Drainbee på netværket, kan læse status, men intet kan ændres via API'et.