API ed esportazioni
Esistono due modi per trasferire i dati da LiteLog ad altri sistemi:
- REST API v1 — per sistemi di terze parti che comunicano automaticamente con LiteLog: ad es. B. un sistema di gestione della proprietà (PMS) che crea un'attività di pulizia durante il check-out dell'ospite o un middleware che sincronizza i dati anagrafici della proprietà.
- Esportazioni CSV e PDF: per buste paga, reporting e invio ai clienti, senza una riga di codice. Vedi Esportazione e spedizione.
API REST v1
Crea chiave API
Puoi gestire le chiavi API nel portale in Impostazioni → Integrazioni sulla scheda API REST:
- Clicca su Crea chiave e assegna un nome (es. “Appartamenti per vacanze PMS”).
- Scegli le Autorizzazioni (Ambiti) che desideri che la chiave abbia, solo quanto necessario.
- La chiave grezza (
ll_live_…) viene visualizzata esattamente una volta. Copialo e conservalo in modo sicuro: dopodiché sarà visibile solo l'inizio della chiave.
Una chiave è legata al tuo client e ad un accesso: vede esattamente gli oggetti visti da questo accesso. La revoca ha effetto immediato; per una rotazione senza errori creare prima la nuova chiave, convertire il sistema di terze parti e poi revocare quello vecchio.
Autenticazione
Ogni richiesta porta la chiave nell'intestazione, come X-Api-Key o come token al portatore:
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 è adatto come primo test: l'endpoint restituisce il contesto della chiave (client, scope) senza richiedere ulteriori permessi.
Endpoint
| Metodo e percorso | Scopo | Ambito richiesto |
|---|---|---|
| CODICE0 | Chiave del test: proprio contesto (cliente, ambiti) | — |
| CODICE0 | Elenca oggetti | CODICE0 |
| CODICE0 | Crea oggetto | CODICE0 |
| CODICE0 | Aggiorna oggetto | CODICE0 |
| CODICE0 | Elenca le attività | CODICE0 |
| CODICE0 | Crea attività (idempotente tramite uuid fornito) | CODICE0 |
| CODICE0 | Creare una segnalazione (incidente/difetto). | CODICE0 |
| CODICE0 | Risposte del modulo inviato alla query (sondaggio) | CODICE0 |
| CODICE0 | Risposta del modulo in dettaglio, comprese risposte e collegamenti a foto | CODICE0 |
:::tip Idempotenz
Quando crei attività, inserisci il tuo uuid: consegne ripetute dello stesso evento (ad esempio riconsegna webhook del tuo PMS) non creeranno mai due attività.
:::
Esempio: “Partenze degli ospiti → attività di pulizia”
# 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"
Confini e comportamento
- Limite di velocità: 120 richieste al minuto per chiave (HTTP 429 se superato).
- Nessuna postazione di licenza: gli accessi API non occupano una postazione di licenza. Una licenza scaduta blocca l'accesso in scrittura (la lettura resta possibile, HTTP 402 in scrittura).
- Formato errore: 401 (Chiave mancante/non valida/revocata), 403 (Ambito o accesso all'oggetto mancante), 404 (Risorsa non presente), 409 (Conflitto/Duplicato), 400/422 (Errore di convalida: i campi sconosciuti vengono rifiutati).
- Non ancora inclusi: Webhook in uscita (pianificati, fino ad allora polling tramite
GET /api/v1/form-responses?status=submitted), OAuth2, monitoraggio del tempo di scrittura o risposte ai moduli, caricamenti di file ed endpoint DELETE.
Esportazioni CSV e PDF
Non hai bisogno di un'API per buste paga e reporting: le esportazioni integrate coprono i casi più comuni:
- Orario di lavoro come CSV — ad es. B. la matrice delle presenze giornaliere per persona per la busta paga.
- Rapporti in formato PDF: tour, notifiche e rapporti su moduli, nel tuo Marchio su richiesta.
- Invio email ricorrente: report automaticamente, ad es. B. inviare settimanalmente ai clienti.
Tutti i dettagli: Esportazione e spedizione e Oggetto: spedizione.
Autorizzazioni
:::info Berechtigung Per creare e revocare le chiavi API, è necessaria l'autorizzazione Modifica impostazioni. Ciò che una chiave può vedere e modificare è limitato anche dal suo ambito e dall'accesso a cui è vincolata. :::