API for RF-HUB

API Oppdatert 2026-05-27

RF-HUB eksponerer et REST API på samme IP som webgrensesnittet — ingen ekstra konfigurasjon er nødvendig. Du finner IP-adressen under fanen Info.

For sanntidsstyring og push-hendelser finnes det også et MQTT-API — se MQTT-API for RF-HUB.

Enheter og styring — `/api/iot`

List alle enheter

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

Returnerer en JSON-array med alle enheter, deres endepunkter, nåværende status og tidsstempel for siste oppdatering:

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

Hent en bestemt enhet

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

Samme JSON-struktur, men bare for én enhet.

Send en kommando til et endepunkt

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
}

Vanlige kommandoer: ON, OFF, eller numeriske verdier for dimmere.

Systemstatus og drift

Endepunkt	Beskrivelse
`GET /status`	App, versjon, UID, WiFi-tilkobling, IP, OTA-fremdrift.
`GET /reboot`	Starter hubben på nytt.
`GET /factory`	Tilbakestilling til fabrikkinnstillinger.
`GET /wifi?ssid=...&password=...`	Endrer WiFi-tilkoblingen.
`GET /backup?sections=settings,devices,schedules,automations`	Laster ned en sikkerhetskopifil. `sections` er valgfritt — utelat for full sikkerhetskopi.
`POST /restore`	Gjenoppretter fra en sikkerhetskopifil.
`POST /ota`	OTA-firmwareoppdatering (send `.bin` som multipart-opplasting).

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 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å et bestemt endepunkt
requests.get(f"{RFHUB}/api/iot/1/12345/1", params={"set": "ON"})

Webhooks?

RF-HUB sender ikke selv utgående HTTP-webhooks. Hvis du trenger det, er det enklest via Home Assistants webhook-automasjoner — RF-HUB publiserer hendelsen via MQTT, og HA gjør HTTP-kallet til din tjeneste.

Spørsmål

Savner du et endepunkt eller trenger hjelp med en bestemt integrasjon — ta kontakt.

Enheter og styring — /api/iot