API for RF-HUB

API Opdateret 2026-05-27

RF-HUB eksponerer et REST API på samme IP som webgrænsefladen — ingen ekstra konfiguration er nødvendig. Du finder IP-adressen under fanen Info.

Til realtidsstyring og push-events findes der også et MQTT-API — se MQTT-API for RF-HUB.

Enheder og styring — `/api/iot`

List alle enheder

GET http://<rfhub-ip>/api/iot

Returnerer et JSON-array med alle enheder, deres endpoints, aktuel status og tidsstempel for seneste opdatering:

[
  {
    "name": "Køkkenbelysning",
    "typeId": 1,
    "brand": "Telldus",
    "addr": 12345,
    "endpoints": [
      {
        "nr": 1,
        "name": "Loftslampe",
        "type": "switch",
        "state": "ON",
        "lastUpdated": "2026-05-20T22:30:15"
      }
    ]
  }
]

Hent en bestemt enhed

GET http://<rfhub-ip>/api/iot/<typeId>/<addr>

Samme JSON-struktur, men kun for én enhed.

Send en kommando til et endpoint

GET http://<rfhub-ip>/api/iot/<typeId>/<addr>/<endpointNr>?set=ON

Sender 433 MHz-signalet og returnerer:

{
  "typeId": 1,
  "addr": 12345,
  "endpointNr": 1,
  "command": "ON",
  "sent": true
}

Almindelige kommandoer: ON, OFF eller numeriske værdier for dimmere.

Systemstatus og drift

Endpoint	Beskrivelse
`GET /status`	App, version, UID, WiFi-forbindelse, IP, OTA-fremgang.
`GET /reboot`	Genstarter hubben.
`GET /factory`	Fabriksindstilling.
`GET /wifi?ssid=...&password=...`	Ændrer WiFi-forbindelsen.
`GET /backup?sections=settings,devices,schedules,automations`	Downloader en sikkerhedskopifil. `sections` er valgfrit — udelad for fuld backup.
`POST /restore`	Gendanner fra en sikkerhedskopifil.
`POST /ota`	OTA-firmwareopdatering (send `.bin` som multipart-upload).

Eksempel — curl

curl "http://192.168.1.50/api/iot/1/12345/1?set=ON"

Eksempel — Python

import requests

RFHUB = "http://192.168.1.50"

# List enheder
devices = requests.get(f"{RFHUB}/api/iot").json()
for d in devices:
    print(d["name"], "→", [(e["name"], e["state"]) for e in d["endpoints"]])

# Tænd et bestemt endpoint
requests.get(f"{RFHUB}/api/iot/1/12345/1", params={"set": "ON"})

Webhooks?

RF-HUB sender ikke selv udgående HTTP-webhooks. Hvis du har brug for det, er det nemmest via Home Assistants webhook-automatiseringer — RF-HUB publicerer hændelsen via MQTT, og HA foretager HTTP-kaldet til din tjeneste.

Spørgsmål

Mangler du et endpoint eller har brug for hjælp med en bestemt integration — kontakt os.

Enheder og styring — /api/iot