Vernetzte Geräte · HTTP-API
Node-RED, Home Assistant oder Ihr Skript, verbunden mit der Instandhaltung
Viele Standorte lesen ihre Zähler bereits irgendwo aus: ein Node-RED-Flow, der einen Modbus-Netzanalysator abfragt, eine Home-Assistant-Instanz mit einem Dutzend Sensoren, ein SPS-Gateway, ein Python-Skript auf einem kleinen PC. Mit FreeMaint Connect kann jedes dieser Systeme seine Werte mit einer einzigen HTTP-Anfrage senden – und diese Messwerte erreichen endlich die Anlagen, die Alarme und die Arbeitsaufträge.
Free your maintenance · Kostenloser Core-Tarif, unbegrenzte Nutzer, ohne Kreditkarte.
Kurz gesagt
FreeMaint Connect nimmt Messwerte von jedem System an, das JSON per HTTP senden kann: Node-RED, Home Assistant, ein Modbus- oder SPS-Gateway, ein Teltonika-Router oder ein Skript. Jede Anfrage trägt einen Zugangsschlüssel im Header und listet Geräte mit ihren Werten auf. FreeMaint rechnet Einheiten um, legt Kanäle mit der ersten Nachricht an und lässt Alarmregeln, Betriebsstundenzähler und Energiezähler sie wie bei jedem zertifizierten Gerät nutzen.
Aktualisiert am 16. Oktober 2026
Was Ihnen die HTTP-API bietet
Eine Anfrage, viele Geräte
Ein einziger POST kann bis zu 500 Geräte und 5.000 Werte tragen, jeder mit eigenem Zeitstempel. Geräte und Kanäle werden mit ihrer ersten Nachricht automatisch angelegt.
Enthalten in BusinessEinheiten, die für Sie umgerechnet werden
Senden Sie Energie in Wh, kWh oder MWh, Temperaturen in °C oder °F, Schwinggeschwindigkeit in mm/s oder in/s: FreeMaint speichert jede Größe in einer einzigen Einheit, damit sich Werte aus verschiedenen Systemen addieren lassen.
Enthalten in BusinessZählerstände, die als Zählerstände verstanden werden
Kennzeichnen Sie einen Wert als kumulativ – eine Energiesumme, einen Betriebsstundenzähler –, und FreeMaint berechnet den Verbrauch zwischen zwei Messwerten, auch über ein Zurücksetzen hinweg.
Enthalten in BusinessDieselben Alarme und Arbeitsaufträge wie bei jedem Gerät
Sobald ein Wert eintrifft, ist er ein Kanal wie jeder andere: Alarmregeln, Schwingungszonen nach ISO 20816, Betriebsstunden, Verknüpfungen mit Anlagen- und Energiezählern und die Live-Ansicht in der mobilen App.
Enthalten in BusinessEin Schlüssel pro Verbindung
Jede Verbindung hat ihren eigenen Zugangsschlüssel, der im Header gesendet wird und nie in der URL. Erneuern Sie ihn jederzeit, wobei der alte 24 Stunden gültig bleibt oder sofort widerrufen wird.
Enthalten in BusinessWann die HTTP-API der richtige Weg ist
Einige Geräte dekodiert FreeMaint selbst – Shelly-Energiezähler und zwei LoRaWAN-Sensoren von Milesight. Alles andere läuft über die HTTP-API, und das deckt den größten Teil eines Industriestandorts ab: einen Modbus-Netzanalysator, den Node-RED ausliest, einen Sensor in Home Assistant, eine Gebäudeleittechnik, die ihre Datenpunkte exportiert, eine SPS, die ihre Zähler bereits veröffentlicht, einen Schwingungssensor, den sein eigenes Gateway ausliest.
Modbus, MQTT, BACnet oder OPC UA spricht FreeMaint nicht direkt. Das ist Absicht: Das Gateway, das ohnehin in Ihrem Netz sitzt, kennt das Protokoll und die Registertabelle, und FreeMaint braucht nur die Werte. Ein Node-RED-Flow oder ein kurzes Skript, das Register in JSON verwandelt, umfasst meist nur wenige Zeilen.
- Node-RED-Flows, die Modbus-RTU- oder Modbus-TCP-Geräte auslesen
- Home-Assistant-Automationen, die Sensoren weiterleiten
- Teltonika-Router mit Data to Server
- SPS- und Gebäudeleittechnik-Gateways
- Skripte auf einem kleinen PC oder einem Raspberry Pi
Wie eine Anfrage aussieht
Die Anfrage ist ein POST an die URL, die FreeMaint beim Anlegen der Verbindung anzeigt, mit zwei Headern: Authorization mit dem Zugangsschlüssel und Content-Type mit dem Wert application/json. Der Body listet Einträge auf: Jeder Eintrag besteht aus einer Gerätekennung, optional einem Anzeigenamen und einem Zeitpunkt, und seinen Messpunkten. Ein Messpunkt hat einen Schlüssel wie power oder energy_total, einen Wert und idealerweise eine Einheit, eine physikalische Größe und, bei Zählerständen, die Art kumulativ.
FreeMaint antwortet mit 202, wenn die Daten angenommen sind, und speichert sie innerhalb von Sekunden. Eine fehlerhafte Anfrage erhält eine Antwort 400, die das Problem benennt – ein falsch konfiguriertes Gateway ist so in Minuten behoben, statt Wochen später entdeckt zu werden. Jede Verbindung nimmt bis zu 120 Anfragen pro Minute an; darüber antwortet FreeMaint mit 429, und Ihr System sollte es später erneut versuchen.
Betriebsstunden und Energie aus Ihrem eigenen System
Zählt Ihre SPS bereits Betriebsstunden, senden Sie den Zählerstand als kumulativen Wert und verknüpfen den Kanal mit dem Betriebsstundenzähler der Anlage: Die Wartungspläne lösen darauf aus. Meldet sie nur Leistung oder Strom, lassen Sie FreeMaint die Betriebsstunden über „Betriebsstunden berechnen“ aus diesem Kanal ermitteln. Für Energie verknüpfen Sie den Kanal mit einem Energiezähler, und FreeMaint erfasst alle 15 Minuten einen Messwert mit seinen Kosten und seinem CO2.
Tarife und Grenzen
Die HTTP-API gehört zu FreeMaint Connect im Business-Tarif für 99 USD pro Monat und Unternehmen, pauschal, mit 100 aktiven Kanälen. Der Enterprise-Tarif enthält 5.000. Ein inaktiver Kanal zählt nicht mit, und bereits empfangene Daten bleiben in jedem Tarif sichtbar. Um den Rest von FreeMaint zu lesen und zu schreiben – Arbeitsaufträge, Anlagen, Ersatzteile –, gibt es außerdem eine GraphQL-API im Business-Tarif und signierte ausgehende Webhooks ab dem Starter-Tarif.
Ihre ersten Werte in vier Schritten senden
- 1
Die Verbindung anlegen
Klicken Sie unter Vernetzte Geräte → Integrationen auf „Gerät verbinden“ und wählen Sie „HTTP-API (Node-RED, Skript…)“.
- 2
URL und Schlüssel kopieren
FreeMaint zeigt die URL, die beiden Header und einen Beispiel-Body an. Der Schlüssel wird nur einmal angezeigt.
- 3
Eine Anfrage senden
Senden Sie aus Node-RED, Home Assistant oder Ihrem Skript das JSON per POST mit den beiden Headern.
- 4
Die Kanäle nutzen
Ordnen Sie das neue Gerät seiner Anlage zu, legen Sie Alarmregeln an und verknüpfen Sie Kanäle mit Zählern.
Häufige Fragen
Kann FreeMaint meinen Modbus-Zähler direkt auslesen?
Nein. Ein Gateway liest die Modbus-Register aus – Node-RED, Home Assistant, ein Teltonika-Router oder ein Skript – und sendet die Werte als JSON per HTTPS an FreeMaint.
Wird MQTT unterstützt?
Nicht direkt. Ein Gateway, das Ihre MQTT-Topics abonniert, etwa Node-RED, kann die Werte an die HTTP-API weiterleiten.
Wie viele Werte kann eine Anfrage tragen?
Bis zu 500 Geräte und 5.000 Messpunkte pro Anfrage, und bis zu 120 Anfragen pro Minute und Verbindung.
Was passiert, wenn meine Anfrage fehlerhaft ist?
FreeMaint antwortet mit 400 und benennt das Problem, sodass Sie das Gateway sofort korrigieren können. Angenommene Daten erhalten eine 202.
Können Werte aus meinem Skript Arbeitsaufträge eröffnen?
Ja. Sobald ein Wert eintrifft, ist er ein Kanal: Eine Alarmregel mit aktiviertem „Arbeitsauftrag erstellen“ eröffnet einen Arbeitsauftrag auf der Anlage.
Wie wird der Zugangsschlüssel übertragen?
Im Header Authorization, nie in der URL. Jede Verbindung hat ihren eigenen Schlüssel; beim Erneuern bleibt der alte 24 Stunden gültig oder wird sofort widerrufen.
Welchen Tarif brauche ich?
Den Business-Tarif für 99 USD pro Monat und Unternehmen, mit 100 aktiven Kanälen. Der Enterprise-Tarif enthält 5.000.
Verwandte Seiten
Nutzen Sie die Daten, die Sie bereits haben
Starten Sie im kostenlosen Core-Tarif und wechseln Sie in den Business-Tarif, sobald Sie Messwerte senden möchten.
Kostenloses Konto erstellen