REST-API & Schnittstellen
Offene REST-API für PMS und Drittsysteme: Objekte synchronisieren, Aufgaben und Meldungen anlegen, Checklisten abrufen – abgesichert per API-Schlüssel mit feinen Berechtigungen.
Was die REST-API umfasst
Ein Ziel: LiteLog spricht mit Ihren Systemen — ohne Doppelerfassung.
Offene Schnittstelle
Standard-REST mit JSON und OpenAPI-Spezifikation — von Objekten bis Workflow-Regeln.
OpenAPI-Datei öffnen →PMS-Automatik
Gast checkt aus — die Endreinigungs-Aufgabe entsteht automatisch am richtigen Objekt.
API-Schlüssel & Scopes
Schlüssel selbst erstellen, Berechtigungen je Schlüssel begrenzen — Widerruf wirkt sofort.
Klare Grenzen
120 Anfragen pro Minute, strikte Validierung — gehostet in Deutschland.
Ressourcen: von Objekten bis Workflow-Regeln
Mit der REST-API sprechen Ihr Property-Management-System, ERP oder eigene Tools direkt mit LiteLog. Die Schnittstelle folgt gängigen REST-Konventionen mit JSON, einer OpenAPI-Spezifikation und eindeutigen Fehlercodes.
- ✓Kernressourcen: Objekte lesen, anlegen und ändern; Aufgaben lesen und anlegen; Meldungen anlegen; eingereichte Formular-Antworten samt Foto-Links abrufen.
- ✓Material per API: Bestand und Buchungen des Material-Moduls lesen, Buchungen anlegen und Materialanforderungen auslösen.
- ✓Verwaltung inklusive: Mitarbeiter-Zugänge samt Einladungslink, Rollen, Formular-Vorlagen und Workflow-Regeln legen Sie per API an — etwa für ein automatisiertes Onboarding.
- ✓Zählt nicht als Mitarbeiter: API-Zugriffe zählen nie zur Mitarbeiterzahl; die Schnittstelle ist ab Stufe Betrieb enthalten.
Gast reist ab, Reinigungsaufgabe entsteht
Der Klassiker aus der Ferienwohnungs-Vermietung: Beim Checkout legt Ihr PMS automatisch die Endreinigungs-Aufgabe zum richtigen Objekt an. Ist die Reinigungs-Checkliste eingereicht, holt sich das PMS das Ergebnis samt Fotos zurück — mehr dazu auf der Branchenseite Ferienwohnungen.
- ✓Idempotent per UUID: Doppelt gesendete PMS-Ereignisse erzeugen nie zwei Aufgaben.
- ✓Übergabeprotokoll mit Fotos: Eingereichte Checklisten fragt Ihr System per Abruf ab — samt Links zu den Fotos, wie in den Berichten.
- ✓Stammdaten synchron: Gebäudedienstleister koppeln auf demselben Weg ERP oder CAFM und halten Objekt-Stammdaten aktuell.
API-Schlüssel & Berechtigungen (Scopes)
API-Schlüssel erstellen Sie selbst im Portal unter Funktionen → Verbindungen — ohne Support-Ticket. Jeder Schlüssel ist an Ihren Mandanten und einen Zugang gebunden und sieht genau die Objekte, die dieser Zugang sieht — im Zusammenspiel mit der Rechte- & Rollenverwaltung.
- ✓Scopes je Schlüssel: Berechtigungen wie „Aufgaben schreiben" oder „Material lesen" begrenzen zusätzlich, was jeder Schlüssel darf.
- ✓Genau einmal sichtbar: Der Roh-Schlüssel wird beim Erstellen ein einziges Mal angezeigt — danach nie wieder.
- ✓Widerruf sofort, Rotation ohne Ausfall: Erst den neuen Schlüssel erstellen, dann den alten widerrufen.
Sicherheit & klare Grenzen
Die API ist auf verlässlichen Betrieb ausgelegt — und wir benennen ehrlich, was (noch) fehlt: Webhooks sind geplant; bis dahin fragt Ihr System neue Daten per Abruf ab. Löschen per API gibt es bewusst nicht. Die REST-API arbeitet mit API-Schlüsseln; OAuth gibt es nur für die KI-Anbindung.
- ✓120 Anfragen pro Minute je Schlüssel: klar dokumentiert, mit eindeutiger Antwort bei Überschreitung.
- ✓Strikte Validierung: Unbekannte Felder werden abgelehnt, Fehler kommen mit Klartext-Code zurück.
- ✓Hosting in Deutschland: DSGVO-konform betrieben — Details in der Cloud-Architektur.
- ✓KI-Anbindung: Ein KI-Werkzeug Ihrer Wahl verbinden Sie über den offenen Standard MCP mit Ihrem Konto. Die Verbindung erbt Rolle und Objekte des Nutzers, der zugestimmt hat.
FAQ
Häufige Fragen zur REST-API (FAQ)
Ab welchem Paket ist die REST-API verfügbar?
Die REST-API ist ab der Stufe Betrieb enthalten und steht auch in Profi und Individuell zur Verfügung. In der Stufe Basis ist sie nicht enthalten.
Zählt ein API-Zugriff als Mitarbeiter?
Nein. API-Zugriffe zählen nicht zur Mitarbeiterzahl. Bei abgelaufener Lizenz bleiben Lesezugriffe offen, Schreibzugriffe sind blockiert.
Welche Daten kann ich über die API lesen und schreiben?
Objekte lesen, anlegen und ändern; Aufgaben lesen und anlegen; Meldungen anlegen; eingereichte Formular-Antworten samt Foto-Links abrufen. Dazu kommen Material (Bestand lesen, Buchungen anlegen, Anforderungen auslösen), Mitarbeiter-Zugänge samt Einladungslink, Rollen, Formular-Vorlagen und Workflow-Regeln. Bewusst nicht enthalten sind Löschen per API, Datei-Uploads und das Schreiben von Zeiterfassung.
Gibt es Webhooks?
Noch nicht — Webhooks sind geplant. Bis dahin fragt Ihr Drittsystem neue Daten per Abruf (Polling) ab, zum Beispiel eingereichte Checklisten.
Wie erstelle und sichere ich einen API-Schlüssel?
Im Portal unter Funktionen → Verbindungen → REST-API. Beim Erstellen wählen Sie Name und Berechtigungen; der Schlüssel wird genau einmal angezeigt. Widerruf wirkt sofort, und für einen Wechsel erstellen Sie erst den neuen Schlüssel und widerrufen dann den alten — ganz ohne Ausfall.
Wo werden die Daten verarbeitet?
In Deutschland (Frankfurt) auf EU-Cloud-Infrastruktur, DSGVO-konform — wie das gesamte LiteLog-System. Details beschreibt die Seite Cloud-Architektur.
Lässt sich LiteLog mit KI-Werkzeugen verbinden?
Ja, über die KI-Anbindung. Sie verbinden ein KI-Werkzeug Ihrer Wahl, zum Beispiel Claude oder ChatGPT, über den offenen Standard MCP mit Ihrem LiteLog-Konto. Jeder Nutzer stimmt im Portal ausdrücklich zu und wählt „Lesen“ oder „Lesen und Schreiben“. Die Verbindung erbt die Rolle und die Objekte dieses Nutzers und lässt sich im Portal jederzeit trennen; ein Administrator kann sie für die Firma abschalten. Löschen kann sie nichts. Details stehen in der Datenschutzerklärung. Voraussetzung ist ein Paket mit REST-API.