API & Exporte
Es gibt zwei Wege, Daten aus LiteLog in andere Systeme zu bringen:
- REST-API v1 — für Drittsysteme, die automatisiert mit LiteLog sprechen: z. B. ein Property-Management-System (PMS), das beim Gast-Checkout eine Reinigungsaufgabe anlegt, oder eine Middleware, die Objekt-Stammdaten synchronisiert.
- CSV- und PDF-Exporte — für Lohnabrechnung, Reporting und den Versand an Auftraggeber, ohne eine Zeile Code. Siehe Export & Versand.
REST-API v1
API-Schlüssel erstellen
API-Schlüssel verwalten Sie im Portal unter Einstellungen → Integrationen auf der Karte REST-API:
- Klicken Sie auf Schlüssel erstellen und vergeben Sie einen Namen (z. B. „PMS Ferienwohnungen").
- Wählen Sie die Berechtigungen (Scopes), die der Schlüssel erhalten soll — nur so viel wie nötig.
- Der Roh-Schlüssel (
ll_live_…) wird genau einmal angezeigt. Kopieren Sie ihn und legen Sie ihn sicher ab — danach ist nur noch der Anfang des Schlüssels sichtbar.
Ein Schlüssel ist an Ihren Mandanten und einen Zugang gebunden — er sieht genau die Objekte, die dieser Zugang sieht. Widerruf wirkt sofort; für eine Rotation ohne Ausfall erstellen Sie zuerst den neuen Schlüssel, stellen das Drittsystem um und widerrufen dann den alten.
Authentifizierung
Jede Anfrage trägt den Schlüssel im Header — entweder als X-Api-Key oder als Bearer-Token:
curl -H "X-Api-Key: ll_live_..." https://api.litelog.de/api/v1/me
# oder
curl -H "Authorization: Bearer ll_live_..." https://api.litelog.de/api/v1/me
GET /v1/me eignet sich als erster Test: Der Endpunkt gibt den Kontext des Schlüssels zurück (Mandant, Scopes), ohne weitere Berechtigungen zu benötigen.
Endpunkte
| Methode & Pfad | Zweck | Benötigter Scope |
|---|---|---|
GET /api/v1/me | Schlüssel testen: eigener Kontext (Mandant, Scopes) | — |
GET /api/v1/properties | Objekte auflisten | properties:read |
POST /api/v1/properties | Objekt anlegen | properties:write |
PATCH /api/v1/properties/:id | Objekt aktualisieren | properties:write |
GET /api/v1/tasks | Aufgaben auflisten | tasks:read |
POST /api/v1/tasks | Aufgabe anlegen (idempotent über mitgegebene uuid) | tasks:write |
POST /api/v1/incidents | Meldung (Vorfall/Mangel) anlegen | incidents:write |
GET /api/v1/form-responses | Eingereichte Formular-Antworten abfragen (Polling) | form_responses:read |
GET /api/v1/form-responses/:id | Formular-Antwort im Detail, inkl. Antworten und Foto-Links | form_responses:read |
:::tip Idempotenz
Geben Sie beim Anlegen von Aufgaben eine eigene uuid mit — wiederholte Zustellungen desselben Ereignisses (z. B. Webhook-Redelivery Ihres PMS) erzeugen dann nie zwei Aufgaben.
:::
Beispiel: „Gast reist ab → Reinigungsaufgabe"
# Checkout-Event → Reinigungsaufgabe
curl -X POST https://api.litelog.de/api/v1/tasks \
-H "X-Api-Key: $KEY" -H "Content-Type: application/json" \
-d '{"uuid":"7c9e6679-7425-40de-944b-e07fc1f90ae7","title":"Endreinigung Wohnung 3","property_id":123,"due_date":"2026-08-01"}'
# Fertige Reinigungs-Checkliste abfragen (Polling)
curl "https://api.litelog.de/api/v1/form-responses?property_id=123&status=submitted&pageSize=10" \
-H "X-Api-Key: $KEY"
Grenzen & Verhalten
- Rate-Limit: 120 Anfragen pro Minute und Schlüssel (HTTP 429 bei Überschreitung).
- Kein Lizenz-Sitz: API-Zugriffe belegen keinen Lizenz-Sitz. Eine abgelaufene Lizenz blockiert Schreibzugriffe (Lesen bleibt möglich, HTTP 402 beim Schreiben).
- Fehlerformat: 401 (Schlüssel fehlt/ungültig/widerrufen), 403 (Scope oder Objektzugriff fehlt), 404 (Ressource nicht vorhanden), 409 (Konflikt/Duplikat), 400/422 (Validierungsfehler — unbekannte Felder werden abgelehnt).
- Noch nicht enthalten: Outbound-Webhooks (geplant — bis dahin Polling über
GET /api/v1/form-responses?status=submitted), OAuth2, Schreiben von Zeiterfassung oder Formular-Antworten, Datei-Uploads und DELETE-Endpunkte.
CSV- & PDF-Exporte
Für Lohnabrechnung und Reporting brauchen Sie keine API — die eingebauten Exporte decken die häufigsten Fälle ab:
- Arbeitszeiten als CSV — z. B. die Tagesmatrix der Anwesenheit pro Person für die Lohnabrechnung.
- Berichte als PDF — Rundgang-, Meldungs- und Formular-Berichte, auf Wunsch im eigenen Branding.
- Wiederkehrender E-Mail-Versand — Berichte automatisch z. B. wöchentlich an Auftraggeber senden.
Alle Details: Export & Versand und Objekt — Versand.
Berechtigungen
:::info Berechtigung Zum Erstellen und Widerrufen von API-Schlüsseln benötigen Sie die Berechtigung Einstellungen bearbeiten. Was ein Schlüssel sehen und ändern darf, begrenzen zusätzlich seine Scopes und der Zugang, an den er gebunden ist. :::