API REST e interfaccia PMS | LiteLog
API REST aperte per PMS e sistemi di terze parti: collega oggetti, attività, messaggi e liste di controllo tramite chiave API. Dal pacchetto Standard (6-15 utenti).
API REST aperte per sistemi di terze parti
Con l'API REST puoi accedere a LiteLog dal tuo sistema di gestione immobiliare, ERP o dai tuoi strumenti. Quattro risorse coprono l'integrazione quotidiana: oggetti (leggi, crea, modifica), attività (leggi, crea), messaggi (crea) e risposte ai moduli inviati, comprese le foto (leggi). L'interfaccia segue le convenzioni REST comuni con JSON e una specifica OpenAPI.
- ✓Oggetti, attività, messaggi, risposte ai moduli
- ✓REST standard con specifiche JSON e OpenAPI
- ✓L'accesso API non occupa spazio utente
L'ospite se ne va → compito di pulizia
Il classico dell'affitto di appartamenti per vacanze: al momento del check-out, il vostro PMS crea automaticamente l'incarico di pulizia finale per l'immobile corretto - grazie alla protezione dall'idempotenza non esiste mai un compito duplicato, anche se gli eventi vengono inviati due volte. Una volta inviata la lista di controllo della pulizia, il PMS recupera i risultati, comprese le foto. I fornitori di servizi di facility management collegano il proprio ERP o CAFM allo stesso modo per sincronizzare i dati anagrafici dell'immobile.
- ✓Attività idempotenti: gli eventi PMS duplicati non creano mai due attività
- ✓Protocollo di consegna con foto su richiesta
- ✓Sincronizzare le anagrafiche degli oggetti dal sistema gestionale
Chiavi API e autorizzazioni (ambiti)
Crei tu stesso le chiavi API nel portale, senza ticket di supporto. Ogni chiave è legata al tuo tenant e ad un accesso e vede esattamente gli oggetti visti da questo accesso. Le autorizzazioni (ambiti) limitano inoltre le operazioni consentite a ciascuna chiave. La chiave grezza viene visualizzata esattamente una volta; La revoca ha effetto immediato, la rotazione avviene senza errori.
- ✓Autorizzazioni dettagliate per chiave
- ✓Visibilità come accesso collegato
- ✓Cancellazione immediata, rotazione senza guasti
Sicurezza e confini chiari
L'API è progettata per un funzionamento affidabile: 120 richieste al minuto per chiave, convalida rigorosa (i campi sconosciuti vengono rifiutati) e codici di errore chiari. E diamo onestamente un nome a ciò che manca (ancora): sono previsti webhook - fino ad allora potrete interrogare nuove liste di controllo su richiesta; OAuth2 e la cancellazione tramite API non sono deliberatamente disponibili. Ospitato in Germania, conforme al GDPR.
- ✓120 richieste/minuto per chiave
- ✓Convalida rigorosa, codici di errore chiari
- ✓Webhook pianificati: sondaggio oggi
FAQ
Domande frequenti sull'API REST (FAQ)
Da quale pacchetto è disponibile l'API REST?
L'API REST è inclusa nel pacchetto Standard (6-15 utenti) ed è disponibile anche in Premium (16-30 utenti) ed Enterprise. Non è incluso nel pacchetto iniziale.
L'accesso API occupa spazio utente?
No. L'accesso API non occupa spazio sulla licenza. Se la licenza è scaduta, l'accesso in lettura rimane aperto e l'accesso in scrittura è bloccato.
Ci sono webhook?
Non ancora: sono previsti webhook. Fino ad allora, il tuo sistema di terze parti interrogherà nuovi dati (polling), ad esempio liste di controllo inviate.
Quali dati posso leggere e scrivere tramite l'API?
Leggere, creare e modificare oggetti; leggere e creare attività; creare report; Recupera le risposte del modulo inviato, inclusi i collegamenti alle foto. Volutamente non sono incluse la cancellazione tramite API, il caricamento di file e la registrazione del tempo di scrittura.
Come posso creare e proteggere una chiave API?
Nel portale in Impostazioni → Integrazioni → API REST. Durante la creazione, scegli il nome e le autorizzazioni; la chiave viene visualizzata esattamente una volta. La revoca ha effetto immediato e per modificare è necessario prima creare la nuova chiave e poi revocare quella vecchia, senza tempi di inattività.