API și exporturi
Există două moduri de a obține date din LiteLog în alte sisteme:
- REST API v1 — pentru sisteme terțe care vorbesc automat cu LiteLog: de ex. B. un sistem de management al proprietății (PMS) care creează o sarcină de curățare în timpul plății oaspeților sau un middleware care sincronizează datele de bază ale proprietății.
- Exporturi CSV și PDF — pentru salarizare, raportare și trimitere către clienți, fără o linie de cod. Vedeți Export și expediere.
API REST v1
Creați cheia API
Gestionați cheile API în portal sub Setări → Integrari pe cardul API REST:
- Faceți clic pe Creați cheia și atribuiți un nume (de exemplu, „apartamente de vacanță PMS”).
- Alegeți Permisiuni (domenii) pe care doriți să le aibă cheia — doar atât cât este necesar.
- Tasta brută (
ll_live_…) este afișată exact o dată. Copiați-l și păstrați-l în siguranță - după aceea, doar începutul cheii va fi vizibil.
O cheie este legată de client și un acces - vede exact obiectele pe care le vede acest acces. Revocarea intră în vigoare imediat; pentru rotație fără eșec, creați mai întâi noua cheie, convertiți sistemul terță parte și apoi revocați-l pe cel vechi.
Autentificare
Fiecare cerere poartă cheia în antet - fie ca X-Api-Key, fie ca simbol purtător:
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 este potrivit ca prim test: punctul final returnează contextul cheii (client, domenii) fără a necesita permisiuni suplimentare.
Puncte finale
| Metodă și cale | Scop | Domeniul de aplicare necesar |
|---|---|---|
GET /api/v1/me | Cheie de testare: context propriu (client, domenii) | — |
GET /api/v1/properties | Listează obiecte | properties:read |
POST /api/v1/properties | Creați obiect | properties:write |
PATCH /api/v1/properties/:id | Actualizați obiectul | properties:write |
GET /api/v1/tasks | Lista sarcinilor | tasks:read |
POST /api/v1/tasks | Creați sarcină (idempotent prin uuid furnizat) | tasks:write |
POST /api/v1/incidents | Creați un raport (incident/defect). | incidents:write |
GET /api/v1/form-responses | Răspunsuri la formulare trimise la interogare (sondare) | form_responses:read |
GET /api/v1/form-responses/:id | Formular de răspuns în detaliu, inclusiv răspunsuri și link-uri foto | form_responses:read |
:::tip Idempotenz
Când creați sarcini, introduceți propriul dvs. uuid - livrările repetate ale aceluiași eveniment (de exemplu, relivrarea webhook a PMS-ului dvs.) nu vor crea niciodată două sarcini.
:::
Exemplu: „Oaspeții pleacă → sarcină de curățare”
# 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"
Limite și comportament
- Rate Limit: 120 de solicitări pe minut per cheie (HTTP 429 dacă este depășit).
- Fără loc de licență: Accesurile API nu ocupă un loc de licență. O licență expirată blochează accesul la scriere (citirea rămâne posibilă, HTTP 402 la scriere).
- Format de eroare: 401 (Cheie lipsă/invalidă/revocată), 403 (Accesul la obiect sau domeniul de aplicare lipsește), 404 (Resursa nu este prezentă), 409 (Conflict/Duplicat), 400/422 (Eroare de validare - câmpurile necunoscute sunt respinse).
- Neincluse încă: Webhook-uri de ieșire (planificate — până atunci sondaj prin
GET /api/v1/form-responses?status=submitted), OAuth2, urmărirea timpului de scriere sau răspunsuri la formulare, încărcări de fișiere și DELETE endpoints.
Exporturi CSV și PDF
Nu aveți nevoie de un API pentru salarizare și raportare - exporturile încorporate acoperă cele mai frecvente cazuri:
- Timp de lucru ca CSV — de ex. B. matricea zilnică de prezență pe persoană pentru salarizare.
- Rapoarte în format PDF — rapoarte de tur, notificare și formulare, în propriul dvs. Branding la cerere.
- Livrare recurentă prin e-mail — Raportează automat, de ex. B. trimite săptămânal clienților.
Toate detaliile: Export și expediere și Obiect — Transport.
Permisiuni
:::info Berechtigung Pentru a crea și a revoca cheile API, aveți nevoie de permisiunea Editare setări. Ceea ce o cheie poate vedea și schimba este, de asemenea, limitat de aria sa și de accesul la care este legată. :::