API für RF-HUB

API Aktualisiert 2026-05-27

RF-HUB stellt eine REST-API unter derselben IP wie die Weboberfläche bereit — keine zusätzliche Konfiguration erforderlich. Die IP-Adresse finden Sie unter dem Reiter Info.

Für Echtzeitsteuerung und Push-Events gibt es außerdem eine MQTT-API — siehe MQTT-API für RF-HUB.

Geräte und Steuerung — `/api/iot`

Alle Geräte auflisten

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

Gibt ein JSON-Array mit allen Geräten, ihren Endpunkten, aktuellem Status und Zeitstempel der letzten Aktualisierung zurück:

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

Ein bestimmtes Gerät abrufen

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

Gleiche JSON-Struktur, aber nur für ein Gerät.

Einen Befehl an einen Endpunkt senden

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

Sendet das 433 MHz-Signal und gibt zurück:

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

Gängige Befehle: ON, OFF oder numerische Werte für Dimmer.

Systemstatus und Verwaltung

Endpunkt	Beschreibung
`GET /status`	App, Version, UID, WiFi-Verbindung, IP, OTA-Fortschritt.
`GET /reboot`	Startet den Hub neu.
`GET /factory`	Werkseinstellungen wiederherstellen.
`GET /wifi?ssid=...&password=...`	Ändert die WiFi-Verbindung.
`GET /backup?sections=settings,devices,schedules,automations`	Lädt eine Sicherungsdatei herunter. `sections` ist optional — weglassen für vollständiges Backup.
`POST /restore`	Stellt aus einer Sicherungsdatei wieder her.
`POST /ota`	OTA-Firmware-Update (senden Sie `.bin` als Multipart-Upload).

Beispiel — curl

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

Beispiel — Python

import requests

RFHUB = "http://192.168.1.50"

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

# Einen bestimmten Endpunkt einschalten
requests.get(f"{RFHUB}/api/iot/1/12345/1", params={"set": "ON"})

Webhooks?

RF-HUB selbst sendet keine ausgehenden HTTP-Webhooks. Wenn Sie das benötigen, geht es am einfachsten über Home Assistants Webhook-Automationen — RF-HUB veröffentlicht das Ereignis über MQTT, und HA führt den HTTP-Aufruf an Ihren Dienst aus.

Fragen

Vermissen Sie einen Endpunkt oder benötigen Sie Hilfe bei einer bestimmten Integration — kontaktieren Sie uns.

Geräte und Steuerung — /api/iot