API y exportaciones

Hay dos formas de transferir datos de LiteLog a otros sistemas:

1. REST API v1 — para sistemas de terceros que hablan automáticamente con LiteLog: p.e. B. un sistema de administración de propiedades (PMS) que crea una tarea de limpieza durante el pago de los huéspedes, o un middleware que sincroniza los datos maestros de la propiedad.
2. Exportaciones CSV y PDF: para nóminas, informes y envíos a clientes, sin una línea de código. Ver Exportación y envío.

API REST v1

Crear clave API

Las claves API se administran en el portal en Configuración → Integraciones en la tarjeta API REST:

1. Haga clic en Crear clave y asigne un nombre (por ejemplo, “apartamentos de vacaciones PMS”).
2. Elija los Permisos (Ámbitos) que desea que tenga la clave, solo los necesarios.
3. La clave sin formato (ll_live_…) se muestra exactamente una vez. Cópielo y guárdelo de forma segura; después de eso, solo será visible el comienzo de la clave.

Una clave está vinculada a su cliente y un acceso: ve exactamente los objetos que ve este acceso. La revocación entra en vigor inmediatamente; para una rotación sin fallas, primero cree la nueva clave, convierta el sistema de terceros y luego revoque el anterior.

Autenticación

Cada solicitud lleva la clave en el encabezado, ya sea como X-Api-Key o como un token al portador:

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 es adecuado como primera prueba: el punto final devuelve el contexto de la clave (cliente, ámbitos) sin requerir más permisos.

Puntos finales

Método y camino	Objetivo	Alcance requerido
CÓDIGO0	Clave de prueba: contexto propio (cliente, ámbitos)	—
CÓDIGO0	Listar objetos	CÓDIGO0
CÓDIGO0	Crear objeto	CÓDIGO0
CÓDIGO0	Actualizar objeto	CÓDIGO0
CÓDIGO0	Listar tareas	CÓDIGO0
CÓDIGO0	Crear tarea (idempotente a través del uuid proporcionado)	CÓDIGO0
CÓDIGO0	Crear un informe (incidente/defecto).	CÓDIGO0
CÓDIGO0	Consulta de respuestas del formulario enviado (encuesta)	CÓDIGO0
CÓDIGO0	Formulario de respuesta en detalle, incluidas respuestas y enlaces de fotos.	CÓDIGO0

:::tip Idempotenz Al crear tareas, ingrese su propio uuid; las entregas repetidas del mismo evento (por ejemplo, la reenvío del webhook de su PMS) nunca crearán dos tareas. :::

Ejemplo: “El huésped se va → tarea de limpieza”

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

Límites y comportamiento

• Límite de velocidad: 120 solicitudes por minuto por clave (HTTP 429 si se excede).
• Sin puesto de licencia: Los accesos a API no ocupan un puesto de licencia. Una licencia caducada bloquea el acceso de escritura (la lectura sigue siendo posible, HTTP 402 al escribir).
• Formato de error: 401 (Clave faltante/no válida/revocada), 403 (Falta acceso al alcance o al objeto), 404 (Recurso no presente), 409 (Conflicto/Duplicado), 400/422 (Error de validación: se rechazan los campos desconocidos).
• Aún no se incluyen: Webhooks salientes (planeados; hasta entonces, sondeo a través de GET /api/v1/form-responses?status=submitted), OAuth2, seguimiento del tiempo de escritura o respuestas de formularios, carga de archivos y puntos finales DELETE.

Exportaciones CSV y PDF

No necesita una API para la nómina y los informes; las exportaciones integradas cubren los casos más comunes:

• Tiempos de trabajo como CSV — p.e. B. la matriz de asistencia diaria por persona para nómina.
• Informes en formato PDF: informes de recorridos, notificaciones y formularios, en su propio Herrada previa solicitud.
• Entrega de correo electrónico recurrente: informes automáticamente, p. B. enviar semanalmente a los clientes.

Todos los detalles: Exportación y envío y Objeto — Envío.

Permisos

:::info Berechtigung Para crear y revocar claves API, necesita el permiso Editar configuración. Lo que una clave puede ver y cambiar también está limitado por su alcance y el acceso al que está vinculada. :::

Páginas relacionadas

• ENLACE0
• ENLACE0
• ENLACE0
• ENLACE0