
La integración de cerraduras en una app, un PMS o una plataforma de edificios se realiza mediante dos conjuntos de herramientas distintos: APIs en la nube para operaciones remotas y SDK de Bluetooth para controlar el dispositivo desde el teléfono cuando está en alcance. Confundirlos es el error más común al planificar una integración.
Cuando una aplicación de terceros necesita operar cerraduras inteligentes — un canal de alquiler que emite códigos, una plataforma de oficinas que habilita visitantes o una app de hotel que entrega llaves móviles — el fabricante de cerraduras expone interfaces programables en dos capas. La API en la nube suele ser un servicio de estilo REST sobre HTTPS: la aplicación se autentica con credenciales de estilo OAuth, crea códigos de acceso o llaves electrónicas, envía órdenes de apertura remota para cerraduras conectadas, consulta el estado de la cerradura y recibe callbacks webhook de eventos de apertura, batería baja y manipulación. El SDK móvil es una biblioteca integrada en la app iOS o Android del integrador que gestiona el descubrimiento por Bluetooth, la conexión segura, la apertura en las proximidades y la lógica de credenciales sin conexión, sin necesidad de能与 un servidor. Las integraciones exitosas utilizan deliberadamente ambas capas, protegen sus credenciales y prueban los límites de solicitudes y la entrega de eventos antes del lanzamiento. Esta guía explica los conceptos y las preguntas al fabricante que son importantes. La disponibilidad, los permisos y las licencias de API y SDK para cada plataforma se confirman por escrito en cada cotización.
| API en la nube | Los servicios HTTPS gestionan cerraduras, credenciales y eventos desde un servidor; alcanzan puertas remotas solo cuando las cerraduras están conectadas mediante Wi-Fi o una pasarela. |
| SDK móvil | Las bibliotecas iOS/Android integradas gestionan la conexión Bluetooth, la apertura en las proximidades y la lógica sin conexión dentro de la app del integrador. |
| Autenticación | Las credenciales de cliente de estilo OAuth, los tokens con permisos y los webhooks firmados separan las plataformas profesionales de los scripts de relé abiertos. |
| Credenciales por API | Las operaciones habituales crean códigos de acceso con fecha de vencimiento, llaves electrónicas, tarjetas y enlaces para visitantes, con endpoints de listado, actualización y revocación. |
| Entrega de eventos | Los webhooks notifican eventos de apertura, uso de códigos, batería baja y puertas; el comportamiento de reintento y las garantías de orden deben estar documentados. |
| Dependencia del hardware | Las órdenes remotas solo se ejecutan en cerraduras conectadas mediante Wi-Fi o una pasarela, por lo que el diseño de la API y la topología del hardware deben planificarse conjuntamente. |
| Nuestra política | Proporcionamos documentación de interfaces, un sandbox o dispositivos de prueba y un contacto técnico; las credenciales y los límites de producción proceden del acuerdo de la plataforma. |
La automatización del lado del servidor (canales de alquiler, PMS, gestión de visitantes) se basa en la API en la nube; las apps de teléfono de marca con control en las proximidades o sin conexión añaden el SDK móvil. Los productos que necesiten ambos deben diseñar el modelo de credenciales antes de escribir código.
| Objetivo de integración | Conjunto principal de herramientas | Dependencia clave |
|---|---|---|
| Emitir códigos de alquiler con fecha de vencimiento | API en la nube desde el backend de reservas | Las cerraduras admiten el tipo de código objetivo y la vía de sincronización. |
| App de marca para inquilinos | SDK móvil más API en la nube | El equipo de la app gestiona el lanzamiento del SDK y la revisión en la tienda. |
| Entrega de llaves móviles de hotel | Eventos de la API en la nube desde el middleware del PMS | Cobertura del servicio de credenciales y de la pasarela en las puertas. |
| Quiosco de gestión de visitantes | API en la nube para credenciales de un solo uso | Las zonas horarias y la semántica de vencimiento se validan a tiempo. |
| Conserjería remota en tiempo real | Apertura mediante API en la nube y confirmación por webhook | Solo las cerraduras conectadas ejecutan órdenes remotas al instante. |
| Carteera empresarial sin conexión | SDK móvil con credenciales locales protegidas | Reglas de almacenamiento de llaves y revocación en el dispositivo. |
Las APIs se encuentran con la realidad física en el acceso: las pasarelas, las puertas metálicas y el consumo de batería determinan si una llamada limpia a la API llega a tiempo a la cerradura. Las pruebas piloto deben abarcar tanto el hardware como el software.
| Acceso | Puerta habitual | Enfoque de cerradura |
|---|---|---|
| Puerta de unidad de alquiler | Cerradura Bluetooth con pasarela por zona | El backend de reservas crea códigos sin conexión y en línea mediante la API en la nube. |
| Entrada de oficinas de cristal | Lector o controlador conectado | La plataforma de visitantes envía credenciales de un solo uso y recibe webhooks de entrada. |
| Habitación de hotel | Cerradura RFID con servicio de llaves móviles | El middleware del PMS llama a la API de llaves; la pasarela envía actualizaciones en tiempo real. |
| Puerta de espacio de trabajo compartido | Cerradura inteligente detrás de una fachada de cristal | La app de miembros integra el SDK para abrir en las proximidades incluso con Wi-Fi débil. |
| Acceso logístico | Cerradura exterior conectada | Las órdenes remotas requieren conectividad confirmada y contactos de respaldo. |
| Sala de servicios | Cerradura con batería gestionada de forma remota | Los webhooks auditan la utilization para facturación y revisión de abuso en la app del operador. |
Las APIs parecen similares en las presentaciones y son diferentes en producción. Antes de comprometer tiempo de ingeniería, los integradores deben recopilar los elementos siguientes, todos ellos cuya coordinación con el equipo de la plataforma ayudamos a gestionar.
| Componente | Lógica habitual | Notas |
|---|---|---|
| Referencia de API | Endpoints, permisos, versiones y disponibilidad del sandbox. | Las estimaciones de ingeniería dependen de documentación completa y actualizada. |
| Paquete SDK | Versiones de OS compatibles, apps de ejemplo y frecuencia de lanzamiento. | Deben comprenderse los modelos de aprobación en la tienda y de mantenimiento. |
| Modelo de seguridad | Tipos de token, rotación de secretos, firma de webhooks y opciones de IP. | Proteger los endpoints de apertura es innegociable en producción. |
| Límites y cuotas | Límites de solicitudes, paginación, operaciones por lotes y reglas de reintento. | De lo contrario, los lanzamientos de flotas pueden fallar en las horas punta de check-in. |
| Catálogo de eventos | Tipos de eventos, cargas útiles, orden y garantías de reentrega. | Las funciones de auditoría y notificación dependen de eventos fiables. |
Una API es una interfaz de servidor a servidor: su backend llama a la plataforma de cerraduras mediante HTTPS para crear códigos, enviar comandos de apertura a cerraduras en línea, consultar el estado y recibir eventos de webhook; funciona independientemente de la proximidad del teléfono. Un SDK móvil es una biblioteca de software integrada en su propia app para iOS o Android que se comunica directamente con las cerraduras mediante Bluetooth, lo que permite la apertura de nearby, la configuración y el almacenamiento de credenciales sin conexión cuando no hay servidor accesible. Los backends de alquiler y las integraciones con PMS necesitan principalmente la API en la nube; las apps de inquilinos con marca suelen necesitar el SDK junto con llamadas seleccionadas a la API. Intentar hacerlo todo mediante la API — por ejemplo, abrir una cerradura únicamente con Bluetooth desde el otro extremo del mundo sin una pasarela — sencillamente no funciona, por lo que la topología del hardware y la elección de la interfaz deben diseñarse conjuntamente. Las interfaces disponibles para cada plataforma se confirman por escrito en cada cotización.
Sí, es un patrón de integración estándar: cuando se confirma una reserva, su backend o middleware llama a la API de la plataforma de cerraduras indicando la habitación o unidad, la llegada y la salida, y recibe una contraseña o ekey que se entrega al huésped mediante su propia plantilla de mensaje o correo electrónico. Los webhooks confirman después el uso y señalan eventos como intentos de check-in anticipado o baterías bajas. Los aspectos que deben concretarse son el tratamiento de las zonas horarias para los periodos de las fechas, el tipo de código que funciona sin conexión en las cerraduras seleccionadas, la cobertura de las pasarelas para la revocación en tiempo real, los reintentos idempotentes cuando se reenvían mensajes y la forma en que las cancelaciones y los cambios de fecha actualizan la credencial. Proporcionamos cerraduras de prueba y apoyamos los talleres de integración; los detalles de los endpoints, los límites de tasa y las licencias de cada plataforma se confirman por escrito en cada cotización.
La apertura remota es segura cuando la plataforma está construida como cualquier API financiera autenticada: tokens al estilo OAuth con permisos limitados, almacenamiento de secretos en el servidor, permisos por empleado, confirmación de comandos mediante webhook, registros de auditoría y aprobación opcional de dos factores para puertas sensibles. Se vuelve peligroso cuando los integradores incorporan secretos de larga duración en apps de teléfono, exponen endpoints de relé abiertos o registran las URL de apertura. También son importantes las medidas físicas: los comandos remotos solo llegan a cerraduras en línea, y las puertas de alta seguridad suelen deshabilitar por completo la apertura remota o exigir una doble aprobación. Durante la debida diligencia, solicite el documento técnico de seguridad, el procedimiento de rotación de tokens y el esquema de firma de webhooks en lugar de aceptar la afirmación de que hay una “API REST disponible”. Coordinamos estas revisiones con el equipo de la plataforma y podemos proponer arquitecturas donde la apertura remota esté limitada a los roles de recepción.
Los webhooks son el canal estándar para eventos — registros de apertura, entradas con código, batería baja, alertas de manipulación y cambios en los sensores de las puertas —, pero la semántica de entrega varía según la plataforma. Las plataformas profesionales firman las cargas útiles, reintentan las entregas fallidas con mecanismos de espera progresiva y proporcionan una API para reconciliar o consultar los eventos perdidos, algo importante porque las redes fallan brevemente y la entrega duplicada es normal; por lo tanto, los consumidores deben tratar los ID de evento de forma idempotente. Las garantías de orden son más débiles: dos eventos generados con pocos segundos de diferencia pueden llegar occasionalmente en orden inverso, por lo que la lógica de auditoría debe usar la marca de tiempo del evento de la cerradura y no la de llegada. Durante la prueba piloto, simule un receptor sin conexión y verifique el comportamiento de reenvío. El catálogo de eventos, la política de reintentos y los endpoints de reconciliación de la plataforma solicitada se documentan por escrito antes de comenzar el desarrollo.
El acceso a la API lo concede la plataforma de cerraduras conforme a sus propios términos para desarrolladores y operadores comerciales, normalmente al propietario de la cuenta: la marca u operador que posee el proyecto en la nube, no automáticamente a cada comprador de una cerradura. La fábrica puede ayudar a habilitar el servicio, proporcionar documentación y coordinar la incorporación técnica, pero no puede asignar derechos que excedan el acuerdo de la plataforma. Algunas plataformas distinguen entre usuarios solo de app, cuentas empresariales con paneles de control y socios desarrolladores certificados con acceso completo a la API; además, algunos endpoints avanzados requieren una revisión de integración aprobada. Por ello, los compradores que planificaren integraciones profundas deben confirmar la elegibilidad como desarrolladores, las tarifas, los términos de tratamiento de datos y las regiones admitidas antes de seleccionar el hardware, porque una cerradura excelente sin derechos de acceso a la API no puede poner en funcionamiento el producto previsto. Los programas actuales para desarrolladores y las licencias de cada plataforma se confirman en cada RFQ.
Comparta sus casos de uso de integración, la pila tecnológica de su equipo y el calendario de lanzamiento en su RFQ. Coordinamos la documentación de la API, los paquetes SDK, los dispositivos de prueba y los acuerdos de plataforma, y apoyamos una prueba piloto conjunta que cubre el funcionamiento sin conexión, los reintentos y los eventos a escala de flota.
Solicitar ficha técnica y cotizaciónResumen de tecnologíasÚltima actualización: 31 de octubre de 2026 · Revisado por el equipo editorial de Smart Lock Factory