Vattennivå och enhetsstatus direkt från ditt hemnätverk.

Hitta enhetens IP

Första anropet

Ett vanligt HTTP GET-anrop räcker. Byt ut IP-adressen mot enhetens adress. Du kan även skriva den direkt i webbläsarens adressfält.

curl http://192.168.1.42/status

Metod

GET

Sökväg

/status

Port

80 (HTTP)

Autentisering

ingen

Svar och fält

Svaret är ett JSON-objekt med Content-Type: application/json och Cache-Control: no-store. Ett anrop startar inte en ny mätning – du får det senaste kända värdet och dess ålder.

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

Senare firmwareversioner kan lägga till fält. Förlita dig inte på nycklarnas ordning.

Integrationsexempel

Alla exempel läser measurement.cm och hanterar null – före första mätningen finns inget värde. Det är vanliga HTTP-anrop; det finns ingen inbyggd Drainbee-integration och inget stöd för Matter eller HomeKit.

sensor:
  - platform: rest
    name: "Drainbee vattennivå"
    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ätning ännu" });
  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 inte 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ätning ännu" if cm is None else f"{cm} cm")
except (OSError, urllib.error.URLError, ValueError, KeyError) as error:
    raise SystemExit(f"Drainbee kan inte nås: {error}")

Fel och hjälp

200

OK

Status som JSON. Enskilda fält kan vara null.

404

Not Found

Okänd sökväg. Bara /status finns – sökvägar som /value är inte tillgängliga i firmware 1.2.5.

405

Method Not Allowed

Endast GET stöds. POST, PUT och DELETE avvisas.

503

Service Unavailable

Status kunde inte skapas just nu. Vänta en stund och försök igen.

Inget svar? Kontrollera i denna ordning:

1. 1

   Stämmer IP-adressen?

   Jämför med Enhetsinställningar → Lokal IP i appen eller routerns enhetslista. Adressen kan ändras efter en omstart av routern – en DHCP-reservation hjälper.

2. 2

   Är firmware uppdaterad?

   GET /status finns från 1.2.5. Äldre firmware svarar inte på den sökvägen. Versionen visas i appens enhetsinställningar.

3. 3

   Samma nätverk?

   Gästnätverk och separata Wi-Fi-nät, till exempel ett IoT-VLAN, blockerar ofta åtkomst mellan enheter. Din klient måste vara i samma nät som Drainbee eller ha en rutt dit.

4. 4

   Har Drainbee ström och Wi-Fi?

   Kontrollera strömförsörjningen och routerns enhetslista. Det lokala API:et behöver Wi-Fi. En förlorad molnanslutning hindrar inte i sig lokal åtkomst.

5. 5

   Fel protokoll?

   Använd http://, inte https://. Vissa webbläsare lägger till https automatiskt – skriv uttryckligen http:// i adressen.

Nätverk och säkerhet

Det lokala API:et är avsett för ditt betrodda hemnätverk. Det saknar autentisering och HTTPS. Alla som kan nå Drainbee i nätverket kan läsa status, men inget kan ändras via API:et.