API és exportálás
Kétféleképpen juthat el adatok a LiteLog szolgáltatásból más rendszerekbe:
- REST API v1 – harmadik féltől származó rendszerekhez, amelyek automatikusan beszélnek a LiteLog-gal: pl. B. ingatlankezelő rendszer (PMS), amely tisztítási feladatot hoz létre a vendég fizetése során, vagy egy köztes szoftver, amely szinkronizálja az ingatlan törzsadatokat.
- CSV- és PDF-exportálás – bérszámfejtéshez, jelentéskészítéshez és az ügyfeleknek való elküldéshez, kódsor nélkül. Lásd: Export & Szállítás.
REST API v1
API-kulcs létrehozása
Az API-kulcsokat a portálon a REST API kártya Beállítások → Integrációk menüpontjában kezelheti:
- Kattintson a Kulcs létrehozása gombra, és rendeljen hozzá egy nevet (pl. „PMS nyaralóapartmanok”).
- Válassza ki az Engedélyek (hatókörök) értékét, amelyet a kulcshoz szeretne rendelni – csak annyit, amennyi szükséges.
- A nyers kulcs (
ll_live_…) pontosan egyszer jelenik meg. Másolja ki és tárolja biztonságosan – ezután már csak a kulcs eleje lesz látható.
Egy kulcs hozzá van kötve az ügyfélhez és egy hozzáféréshez – pontosan azokat az objektumokat látja, amelyeket ez a hozzáférés lát. A visszavonás azonnal hatályba lép; a hiba nélküli forgatás érdekében először hozza létre az új kulcsot, alakítsa át a harmadik féltől származó rendszert, majd vonja vissza a régit.
Hitelesítés
Minden kérés tartalmazza a kulcsot a fejlécben – akár X-Api-Key-ként, akár hordozó tokenként:
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
A GET /v1/me alkalmas első tesztnek: a végpont visszaadja a kulcs kontextusát (kliens, hatókörök) anélkül, hogy további engedélyekre lenne szüksége.
Végpontok
| Módszer és út | Cél | Szükséges hatókör |
|---|---|---|
GET /api/v1/me | Tesztkulcs: saját kontextus (kliens, hatókörök) | — |
GET /api/v1/properties | Objektumok listázása | properties:read |
POST /api/v1/properties | Objektum létrehozása | properties:write |
PATCH /api/v1/properties/:id | Objektum frissítése | properties:write |
GET /api/v1/tasks | Feladatok listázása | tasks:read |
POST /api/v1/tasks | Feladat létrehozása (idempotens a megadott uuid-on keresztül) | tasks:write |
POST /api/v1/incidents | Készítsen jelentést (incidens/hiba). | incidents:write |
GET /api/v1/form-responses | Elküldött űrlapválaszok lekérdezése (lekérdezés) | form_responses:read |
GET /api/v1/form-responses/:id | A válaszok részletes kitöltése, beleértve a válaszokat és a fotólinkeket | form_responses:read |
:::tip Idempotenz
Feladatok létrehozásakor adja meg a saját uuid kódját – ugyanazon esemény ismételt kézbesítése (például a PMS webhookos újrakézbesítése) soha nem hoz létre két feladatot.
:::
Példa: „Vendég távozik → takarítási feladat”
# 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"
Határok és viselkedés
- Sebességkorlát: 120 kérés percenként kulcsonként (HTTP 429, ha túllépi).
- Nincs licenchely: Az API-hozzáférések nem foglalnak el licenchelyet. A lejárt licenc blokkolja az írási hozzáférést (az olvasás továbbra is lehetséges, a HTTP 402 íráskor).
- Hiba formátuma: 401 (hiányzó kulcs/érvénytelen/visszavonva), 403 (hiányzó hatókör vagy objektum hozzáférés), 404 (nincs erőforrás), 409 (ütközés/duplikáció), 400/422 (érvényesítési hiba – az ismeretlen mezőket elutasítjuk).
- Még nem tartalmazza: Kimenő webhookok (tervezve – addig lekérdezés
GET /api/v1/form-responses?status=submitted-on keresztül), OAuth2, írási időkövetés vagy űrlapválaszok, fájlfeltöltések és végpontok TÖRLÉSE.
CSV és PDF exportálás
Nincs szüksége API-ra a bérszámfejtéshez és a jelentéskészítéshez – a beépített exportálás a leggyakoribb eseteket fedi le:
- Munkaidő CSV-ként — pl. B. a napi jelenléti mátrix személyenként a bérszámfejtéshez.
- Jelentések PDF formátumban – körutazás, értesítések és űrlapjelentések, kérésre saját Márkaépítés-ban.
- Ismétlődő e-mail kézbesítés — Automatikusan jelenti pl. B. hetente küldje el az ügyfeleknek.
Minden részlet: Export & Szállítás és Tárgy – Szállítás.
Engedélyek
:::info Berechtigung API-kulcsok létrehozásához és visszavonásához Beállítások szerkesztése engedély szükséges. Azt, hogy egy kulcs mit láthat és változtathat meg, szintén korlátozza a hatóköre és a hozzá kötött hozzáférés. :::