API för RF-HUB

Avancerat Uppdaterad 2026-05-20

RF-HUB exponerar ett REST API på samma IP som webbgränssnittet — ingen extra konfiguration behövs. Du hittar IP-adressen under fliken Info.

För realtidsstyrning och push-events finns även ett MQTT-API — se MQTT-API för RF-HUB.

Enheter och styrning — `/api/iot`

Lista alla enheter

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

Returnerar en JSON-array med alla enheter, deras ändpunkter, aktuell status och tidsstämpel för senaste uppdatering:

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

Hämta en specifik enhet

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

Samma JSON-struktur men bara för en enhet.

Skicka kommando till en ändpunkt

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

Skickar 433 MHz-signalen och returnerar:

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

Vanliga kommandon: ON, OFF, eller numeriska värden för dimmer.

Systemstatus och drift

Endpoint	Beskrivning
`GET /status`	App, version, UID, WiFi-anslutning, IP, OTA-progress.
`GET /reboot`	Startar om hubben.
`GET /factory`	Fabriksåterställning.
`GET /wifi?ssid=...&password=...`	Byter WiFi-anslutning.
`GET /backup?sections=settings,devices,schedules,automations`	Hämtar backup som fil. `sections` är valfri — utelämna för full backup.
`POST /restore`	Återställer från backup-fil.
`POST /ota`	OTA-uppdatera firmware (skicka `.bin` som multipart upload).

Exempel — curl

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

Exempel — Python

import requests

RFHUB = "http://192.168.1.50"

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

# Slå på en specifik ändpunkt
requests.get(f"{RFHUB}/api/iot/1/12345/1", params={"set": "ON"})

Webhooks?

RF-HUB själv skickar inte utgående HTTP-webhooks. Om du behöver det gör du det enklast via Home Assistants webhook-automationer — RF-HUB publicerar händelsen via MQTT, HA gör HTTP-anropet till din tjänst.

Frågor

Saknar du en endpoint eller behöver hjälp med en specifik integration — hör av dig.

Enheter och styrning — /api/iot