API et exportations

Il existe deux manières d'obtenir des données de LiteLog vers d'autres systèmes :

1. API REST v1 — pour les systèmes tiers qui communiquent automatiquement avec LiteLog : par ex. B. un système de gestion immobilière (PMS) qui crée une tâche de nettoyage lors du départ des clients, ou un middleware qui synchronise les données principales de la propriété.
2. Exportations CSV et PDF — pour la paie, les rapports et l'envoi aux clients, sans ligne de code. Voir Exportation et expédition.

API REST v1

Créer une clé API

Vous gérez les clés API dans le portail sous Paramètres → Intégrations sur la carte API REST :

1. Cliquez sur Créer une clé et attribuez un nom (par exemple « Appartements de vacances PMS »).
2. Choisissez les Autorisations (Portées) que vous souhaitez attribuer à la clé, uniquement dans la mesure nécessaire.
3. La clé brute (ll_live_…) s'affiche exactement une fois. Copiez-le et stockez-le en toute sécurité. Après cela, seul le début de la clé sera visible.

!LIEN0

Une clé est liée à votre client et à un accès - elle voit exactement les objets que cet accès voit. La révocation prend effet immédiatement ; pour une rotation sans échec, créez d'abord la nouvelle clé, convertissez le système tiers puis révoquez l'ancienne.

Authentification

Chaque requête contient la clé dans l'en-tête, soit sous la forme X-Api-Key, soit sous la forme d'un jeton de porteur :

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 convient comme premier test : le point de terminaison renvoie le contexte de la clé (client, scopes) sans nécessiter d'autorisations supplémentaires.

Points de terminaison

Méthode et chemin	But	Portée requise
GET /api/v1/me	Clé de test : propre contexte (client, étendues)	—
GET /api/v1/properties	Liste des objets	properties:read
POST /api/v1/properties	Créer un objet	properties:write
PATCH /api/v1/properties/:id	Mettre à jour l'objet	properties:write
GET /api/v1/tasks	Liste des tâches	tasks:read
POST /api/v1/tasks	Créer une tâche (idempotent via le uuid fourni)	tasks:write
POST /api/v1/incidents	Créer un rapport (incident/défaut).	incidents:write
GET /api/v1/form-responses	Requête des réponses au formulaire soumis (sondage)	form_responses:read
GET /api/v1/form-responses/:id	Formulaire de réponse en détail, y compris les réponses et les liens photo	form_responses:read

:::tip Idempotenz Lors de la création de tâches, saisissez votre propre uuid - les diffusions répétées du même événement (par exemple la redistribution du webhook de votre PMS) ne créeront alors jamais deux tâches. :::

Exemple : « L'invité part → tâche de nettoyage »

# 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"

Limites et comportement

• Limite de débit : 120 requêtes par minute et par clé (HTTP 429 si dépassé).
• Aucun poste de licence : Les accès API n'occupent pas de poste de licence. Une licence expirée bloque l'accès en écriture (la lecture reste possible, HTTP 402 en écriture).
• Format d'erreur : 401 (Clé manquante/invalide/révoquée), 403 (Portée ou accès à l'objet manquant), 404 (Ressource non présente), 409 (Conflit/Duplicata), 400/422 (Erreur de validation - les champs inconnus sont rejetés).
• Pas encore inclus : Webhooks sortants (prévus - jusque-là, interrogation via GET /api/v1/form-responses?status=submitted), OAuth2, suivi du temps d'écriture ou réponses de formulaire, téléchargements de fichiers et points de terminaison DELETE.

Exportations CSV et PDF

Vous n'avez pas besoin d'une API pour la paie et le reporting : les exports intégrés couvrent les cas les plus courants :

• Temps de travail au format CSV — par ex. B. la matrice de présence journalière par personne pour la paie.
• Rapports au format PDF — rapports de visite, de notification et de formulaire, dans votre propre Image de marque sur demande.
• Envoi récurrent d'e-mails — Rapports automatiquement, par ex. B. envoyer chaque semaine aux clients.

Tous les détails : Exportation et expédition et Objet — Expédition.

Autorisations

:::info Berechtigung Pour créer et révoquer des clés API, vous avez besoin de l'autorisation Modifier les paramètres. Ce qu'une clé peut voir et modifier est également limité par sa portée et l'accès auquel elle est liée. :::

Pages connexes

• LIEN0
• LIEN0
• LIEN0
• LIEN0