Integraciones más comunes: cómo hacerlo
La capa de API de LabKey es estable y se utiliza en producción desde hace años para conectar el control de accesos con software de gestión, PMS, plataformas de reservas y sistemas de pago. Esta guía recoge los patrones de integración más comunes — basados en casos reales ya en producción, aquí descritos de forma genérica — para orientarte rápidamente antes de diseñar tu propia integración.
Cómo empezar una integración
Hay tres modalidades posibles, según los recursos técnicos disponibles:
- Self-service: desarrolla de forma autónoma a partir de la documentación completa de las API, disponible también en formato interactivo en Postman.
- SDK y código de partida: el equipo de LabKey puede proporcionar SDK y fragmentos de código ya listos para los patrones más comunes, para acelerar el desarrollo.
- Integración a medida: el equipo de LabKey puede desarrollar la integración a medida por cuenta del cliente.
Contáctanos para evaluar juntos la vía más adecuada para tu proyecto.
Patrones de integración más comunes
A continuación, los patrones de integración más recurrentes, extraídos de integraciones realmente en producción (algunas desde hace varios años), descritos de forma genérica.
Generación automática de credenciales desde un software de gestión de reservas
El software de gestión de reservas (PMS hotelero, software para centros deportivos o coworking) notifica la finalización de una reserva o de un check-in; el sistema genera automáticamente una credencial (código, llave NFC o código QR) válida solo durante el periodo de estancia o reserva, y la envía al usuario.
Llamadas involucradas: AddUser → GrantAccess → getqrcode o UpdatePinpad → sendemail — consulta las secciones Usuarios, Accesos y permisos y General de la documentación de la API.
Patrón típico para la integración con software de gestión cloud para alojamientos, como Passepartout, Hotel in Cloud o TeamSystem Hospitality (ya partners de LabKey).
Verificación de autorización en un sistema externo antes de la apertura
En algunos contextos (por ejemplo, entes públicos con su propio sistema de autorización) la solicitud de apertura no llega directamente desde LabKey: un servicio externo verifica primero la autorización en el software de gestión de terceros y, solo en función del resultado, envía el comando de apertura. Útil cuando la lógica de autorización debe permanecer centralizada en un sistema ya existente.
Acceso por consumo, con crédito recargable
Un área privada externa permite al usuario recargar un crédito (por ejemplo, para entradas, servicios o consumos que se descuentan); el crédito restante se descuenta automáticamente en cada acceso, con deshabilitación automática de la credencial al agotarse el saldo.
Llamadas involucradas: getcredits, recharge, getprices — consulta la sección Créditos.
Autorregistro público con confirmación de un operador
Una página pública permite al usuario registrarse de forma autónoma; el sistema genera un código provisional, que se activa definitivamente solo tras la confirmación manual de un operador.
Llamadas involucradas: AddUser (creado deshabilitado) → confirmación del operador → GrantAccess.
Apertura activada por automatizaciones no-code o formularios online
La cumplimentación de un formulario online (por ejemplo, JotForm, ya partner de LabKey) o una automatización en plataformas de automatización no-code (por ejemplo, Zapier, Make) puede activar directamente la apertura de un acceso, mediante las llamadas de la API PRO.
Pago online que genera el acceso
Un sitio web o un e-commerce con pago integrado (por ejemplo, Stripe) genera y envía automáticamente un código de acceso al completarse una transacción.
Apertura desde la propia app mediante código QR
Si la apertura debe producirse desde la propia app en lugar de desde un lector físico, el flujo típico es: AddUser → GrantAccess → getqrcode. La app del cliente muestra o procesa el código QR devuelto para completar el acceso.
Alternativa a evaluar con conocimiento de causa: si se prefiere actuar directamente sobre el relé de la centralita con un dispositivo externo propio (el contacto es libre de potencial, normalmente abierto — N/A — y puede accionarse en paralelo sin problemas), se omite por completo la capa de API de LabKey: sin autenticación, sin logs, sin ninguna de las funcionalidades del panel. Es una opción válida si la lógica de autorización ya se gestiona en otro lugar, pero debe adoptarse sabiendo a qué se renuncia.
Coworking y espacios compartidos
Grupos de usuarios con franjas horarias personalizables, accesos temporales mediante código QR, contadores de entradas y revocación de credenciales a distancia son todas funcionalidades nativas del sistema, disponibles también vía API para integrarlas con un sitio web o un software de gestión de reservas de espacios.
Requisitos técnicos
La autenticación (token Bearer, secret key asociada a la IP autorizada) se describe en la sección Autenticación de la documentación de la API. Dos aspectos a tener en cuenta durante el diseño:
- La activación de las API afecta a todas las centralitas asociadas al panel: no es posible activarla solo en una selección.
- Hay disponible un entorno de pruebas dedicado, activable a petición, para validar la integración antes de pasar a producción.
Niveles de servicio: Standard y PRO
El servicio de API Standard cubre la mayor parte de los escenarios descritos arriba. El servicio API PRO añade la apertura remota desde software externos mediante llamadas dedicadas y el monitoreo avanzado con log de las llamadas API.
¿Tu plataforma no está entre los partners indicados?
No es un problema: los patrones descritos arriba se aplican del mismo modo también a plataformas que aún no figuran en la lista pública de partners integrados — por ejemplo, los principales channel managers para alquileres de corta duración como Lodgify todavía no son una integración documentada, pero se pueden integrar con el mismo patrón estándar.
Contáctanos para evaluar juntos la viabilidad de tu integración.