SDK de puerta de torniquetes & API: Guía de integración para desarrolladores e integradores de sistemas
2026-03-25
Las puertas de torniquetes de Ironman soportan integración completa de SDK y API con sistemas de software de terceros — incluyendo plataformas de venta de billetes, Sistemas de asistencia de RRHH, Herramientas de gestión de visitantes, y sistemas de gestión de edificios. Esta guía cubre lo que contiene el paquete API del SDK de la puerta de torniquetes, qué tipos de API son compatibles, y cómo probar una conexión en vivo usando Postman. Si eres desarrollador o integrador de sistemas evaluando un proveedor de torniquetes, Esta es la referencia técnica que necesitas antes de tomar una decisión.
Para despliegues conectados a la nube, ver nuestroSistemas de puertas de torniquetes basados en la nube — estos modelos incluyen soporte nativo de API de fábrica.
SDK vs. API — Qué hace cada uno para la integración de torniquetes
Un SDK de puerta de torniquete y una API cumplen funciones diferentes en el proceso de integración. Entender esta distinción ahorra tiempo de configuración y evita los malentendidos técnicos más comunes al iniciar un nuevo proyecto.
ElSDK es el paquete completo de desarrollo. Incluye documentación, Ejemplos de código, Especificaciones de cableado, Una placa de interfaz, y utilidades de prueba. Usas el SDK durante la fase de configuración y construcción — antes de que tu software esté disponible.
ElAPI es la interfaz de comandos que tu software llama durante la operación en tiempo real. Cada vez que un usuario presenta una credencial en la puerta, tu plataforma envía una solicitud de API, y el controlador de torniquetes responde con un resultado.
| SDK | API | |
|---|---|---|
| Qué es | Paquete completo de desarrollo | Interfaz de mandos e datos |
| ¿Quién lo usa | Revelador durante la configuración | Software durante la operación en tiempo real |
| Lo que contiene | Docs, Ejemplos de código, Placa de interfaz, Herramientas de prueba | Puntos finales, Parámetros, Formatos de respuesta |
| Cuando lo necesites | Fase de integración y pruebas | Cada transacción de puerta tras la puesta en marcha |
Piénsalo así: el SDK es lo que usas para construir la conexión. La API es la que lo ejecuta después.
Qué contiene el paquete SDK de la puerta de torniquetes de Ironman
Cuando solicitas un paquete SDK a Ironman, Recibes más que un simple archivo documental. El paquete cubre todo lo que un desarrollador necesita para completar una integración funcional desde el primer día.
Archivos de documentación y especificaciones
El paquete de documentación incluye:
- Especificación del protocolo de hardware: Define el formato de comunicación para Wiegand de 26 y 34 bits, Serie RS485, y salidas de relés de contacto seco
- Referencia de endpoint API: Lista completa de mandos, Definiciones de parámetros, y descripciones de códigos de respuesta
- Diagrama de cableado: Disposición de la conexión para la placa de interfaz API al puerto de control de la puerta
- Tipos de credenciales soportados: RFID, Código QR, biométrico (Salida Wiegand desde el terminal), y entrada PIN
Cada documento se envía con el orden de hardware. Si tu proyecto requiere mapeo personalizado de credenciales o protocolos no estándar, El equipo de ingeniería de Ironman revisa los requisitos antes de enviar.
Herramientas de software y código de ejemplo
La capa de software del SDK incluye:
- Placa de interfaz API: Un componente físico de hardware que conecta el controlador del torniquete con tu entorno de software (Servidor local, Punto final en la nube, o PC local)
- Ejemplos de código: Proporcionado en lenguajes comunes según la plataforma de tu proyecto — incluyendo ejemplos de integración para el manejo de solicitudes HTTP POST
- Utilidades de prueba: Se utiliza para verificar el éxito de las llamadas API antes de conectarse a un sistema de producción
- Soporte IT directo: El equipo técnico de Ironman ayuda con la configuración de las pruebas de Postman y valida la primera 50 Transacciones en vivo durante la puesta en servicio
En nuestra experiencia desplegando integraciones API para proyectos de locales y transporte público, La placa de interfaz y la documentación se resuelven juntas 90% de preguntas de integración antes de que se necesite un único ticket de soporte.
Tipos de API soportados por puertas de torniquetes Ironman
Las compuertas de torniquetes de Ironman soportan tres rutas principales de integración API. La correcta depende de tu arquitectura de software, Entorno de red, y tipo de credencial.
REST API (Basado en HTTP)
La API REST es la vía de integración más común para plataformas de software modernas. Tu aplicación envía solicitudes HTTP POST o GET al punto final de la API del torniquete. El controlador responde con una carga útil JSON — credencial válida/inválida, Estado de puertas abiertas/cerradas, y una marca temporal de evento.
Este camino se adapta a las plataformas de venta de billetes SaaS, Sistemas de asistencia de RRHH basados en la web, y herramientas de gestión de visitantes alojadas en la nube. Requiere una conexión de red entre tu servidor y la placa de interfaz del torniquete, ya sea LAN o internet, Dependiendo del modelo.
SDK + Placa de interfaz (Puente hardware-software-software)
Para entornos sin conexión de red — incluyendo instalaciones offline, Zonas de seguridad con espacio aéreo, o sistemas ERP heredados en las instalaciones — la placa de interfaz se conecta directamente a un servidor local o PC mediante RS485 o RS232.
El SDK proporciona los archivos de controlador y biblioteca que tu servidor necesita para leer señales de puerta y escribir decisiones de acceso en el controlador. Este camino es común en instalaciones de fabricación y campus corporativos que gestionan sistemas de RRHH locales.
Capa de Software de Protocolo Wiegand
Cuando los lectores de credenciales emiten señales Wiegand de 26 o 34 bits, el SDK proporciona la biblioteca de analizadores que tu software utiliza para interpretar esas señales. Esto es especialmente relevante para los sistemas de asistencia de RRHH, donde los lectores de tarjetas RFID ya están conectados al controlador del torniquete.
Wiegand ha sido el protocolo de facto de la industria desde los años 60 y sigue siendo el estándar de comunicación por hardware más instalado en los sistemas de control de acceso existentes.
Flujo de trabajo de integración de API paso a paso
Completar la integración de una API SDK con puerta de torniquete sigue un proceso claro de seis pasos. La mayoría de los proyectos llegan a la puesta en marcha entre 48 y 72 horas desde la recepción del paquete SDK, siempre que la plataforma de software de destino tenga una API activa.
Pasos 1–3: Configuración y conexión
Paso 1 — Solicita tu paquete SDK: Contacta con Ironman con las especificaciones de tu proyecto — el modelo de puerta, Tipo de credencial (Código QR, Tarjeta RFID, Terminal biométrico), y tu plataforma de software objetivo. El equipo de ingeniería confirma la compatibilidad y envía el paquete.
Paso 2 — Recibir el paquete SDK: Recibes la placa de interfaz de la API por correo y los archivos de documentación por correo electrónico. Revisa la referencia del endpoint API y el diagrama de cableado antes de abrir el armario de compuertas.
Paso 3 — Cablear la placa de interfaz: Conecta la placa de interfaz al puerto de control de la puerta de torniquetes usando el diagrama de cableado. Enciende el sistema y confirma que los indicadores de estado LED en la placa muestran una conexión activa.
Pasos 4–6: Pruebas y puesta en marcha
Paso 4 — Configurar el endpoint de la API: Configura tu software para enviar solicitudes HTTP a la dirección IP local de la placa de interfaz (para instalaciones LAN) o punto final en la nube (para modelos conectados a la nube).
Paso 5 — Prueba con el cartero: Carga el documento de referencia de la API en Postman. Construye una solicitud POST de prueba con una carga útil de credenciales de ejemplo — por ejemplo, una cadena de código QR que generaría tu sistema de tickets. Envía la solicitud y confirma que la puerta responde con el resultado JSON esperado. El equipo de TI de Ironman puede revisar tu configuración de Postman y validar directamente los resultados de las pruebas si es necesario.
Paso 6 — Conectarse a su sistema de producción: Una vez que pasan los exámenes de Postman, Apunta tu software en vivo al mismo punto final. Monitoriza la primera 50 transacciones reales antes de eliminar el entorno de pruebas. Tras la confirmación, La integración está lista para producción.
Casos de uso comunes y sistemas de software compatibles
La API SDK de la puerta de torniquetes soporta una amplia gama de plataformas de software en diferentes sectores. Estos son los cuatro escenarios de despliegue más comunes que maneja el equipo de ingeniería de Ironman.
- Venta de entradas y gestión del recinto: Se escanea un código QR en el teléfono del usuario o en el billete impreso en la puerta. La API envía la cadena QR a la plataforma de tickets, que devuelve una respuesta válida/inválida. La puerta solo se abre en caso de respuesta válida. Utilizados en estadios, Salas de conciertos, Salas de exposiciones, y parques temáticos.
- Asistencia de RRHH y seguimiento del tiempo: Una tarjeta RFID o un escaneo de huellas dactilares activa una llamada API al sistema de RRHH. El sistema registra el tiempo de entrada, ID de empleado, y Gate Lane. Utilizados en plantas de fabricación, Centros logísticos, y oficinas corporativas.
- Sistemas de gestión de visitantes (VMS): Un visitante preregistrado recibe un código QR único por correo electrónico. Cuando se escanea en la puerta, la API valida el código contra la VMS y notifica al host. No se requiere facturación en recepción.
- Sistemas de gestión de edificios (BMS): La puerta conecta mediante RS485 al controlador BMS. Estado de la puerta, Recuento de pasajes, y los eventos de alarma se alimentan en el salpicadero del edificio en tiempo real.
Para plataformas empresariales como Lenel, Genetec, Brivo, o Honeywell Pro-Watch, confirmar la ruta de la API (SDK REST o RS485) con el equipo Ironman antes de especificar — la compatibilidad varía según la versión de la plataforma.
ParaDespliegue de torniquetes de seguridad de altura completa en instalaciones gubernamentales o de alta seguridad, se aplica el mismo SDK: la capa de integración no cambia en función del factor de forma de la puerta.
Referencia de protocolo de hardware para desarrolladores
Elegir el protocolo de hardware adecuado es la primera decisión en cualquier proyecto de integración. Esta tabla muestra los protocolos principales que soporta las compuertas de torniquetes Ironman, sus límites técnicos, y el mejor caso de uso para cada uno.
| Protocolo | Tipo | Distribución | Dispositivos por línea | Mejor caso de uso |
|---|---|---|---|---|
| Wiegand 26/34 bits | Hardware | ≤150 m | 1 por puerto controlador | Lector → controlador RFID |
| RS485 | Serie | ≤1.200 m | Hasta 32 | Panel a puerta, Integración con BMS |
| RS232 | Serie | ≤13m | 1 por puerto | Depuración, Actualización de firmware |
| Contacto seco (VFC) | Hardware | Alcance corto | N/A | Relé sencillo de abrir/cerrar |
| REST API (HTTP) | Software | LAN/Internet | Ilimitado | Venta de billetes en la nube, HR, VMS |
| OSDP V2 | Hardware | ≤1.200 m | Múltiples | Alta seguridad, AES-128 cifrado |
Para integraciones puramente de software: La API REST es la ruta correcta. Para puentes hardware-a-software en entornos de red: RS485 con la placa de interfaz SDK es estándar. Se recomienda OSDP V2 para despliegues que requieran comunicación cifrada por lector AES-128 — especialmente relevante para el gobierno, atención sanitaria, y puntos de acceso a centros de datos.
Para proyectos que se desplieganTorniquetes de puerta de velocidad inteligente en entradas de alto rendimiento, La API REST vía LAN es la vía preferida de integración — gestiona tasas de transacción sostenidas de 40–60 personas por minuto por carril sin retrasos en las colas.
Preguntas frecuentes
Q1: ¿Cuál es la diferencia entre un SDK de puerta de torniquete y una API??
El SDK es el paquete completo de desarrollo que usas para construir la integración — incluye documentación, Ejemplos de código, una placa de interfaz API, y herramientas de prueba. La API es la interfaz de comandos que tu software llama durante la operación en tiempo real. Necesitas el SDK para configurar la conexión. Usas la API cada vez que la puerta procesa una credencial tras la puesta en funcionamiento.
P2: ¿El SDK de la puerta de torniquetes de Ironman soporta código QR e integración biométrica??
Sí. El SDK soporta validación de códigos QR mediante la API REST (tu plataforma de tickets o VMS proporciona la respuesta QR), Lectura de tarjetas RFID mediante Wiegand de 26/34 bits, y terminales biométricos que emiten una señal Wiegand. Para terminales de reconocimiento facial con protocolos propietarios, El equipo de ingeniería de Ironman revisa la compatibilidad antes de confirmar el paquete SDK.
P3: ¿El SDK de la puerta de torniquetes es gratuito o cuesta un extra??
La documentación del SDK y la referencia de la API se proporcionan sin coste adicional con órdenes confirmadas en la puerta. La placa de interfaz API es un componente físico de hardware que se entrega con la puerta. Contacta con el equipo de ventas de Ironman para confirmar la inclusión del SDK en tu pedido específico y alcance de proyecto.
P4: ¿Cuánto tiempo se tarda en completar la integración de una API de torniquete??
La mayoría de las integraciones llegan a la puesta en funcionamiento en un plazo de 48–72 horas tras recibir el paquete SDK, siempre que la plataforma de software objetivo tenga una API activa y un desarrollador disponible para las pruebas. Las integraciones multipuerta o ERP más complejas pueden tardar entre 5 y 10 días laborables. El equipo de TI de Ironman ofrece soporte directo durante la fase de pruebas, lo que reduce significativamente el vaivén.
P5: ¿Puedo integrar una puerta de torniquetes con un sistema de asistencia o ERP de RRHH existente??
Sí. Las rutas RS485 y REST API del SDK soportan integración con plataformas de asistencia de RRHH y sistemas ERP. Tendrás que confirmar que tu ERP tiene un endpoint API disponible o soporta comunicación serial RS485. El equipo de Ironman puede revisar la documentación de la API de tu sistema y asesorarte sobre la ruta correcta de integración antes de hacer el pedido.
P6: ¿Qué pasa si la conexión API a la puerta de torniquetes se desconecta??
Las compuertas Ironman con almacenamiento de credenciales a bordo pueden seguir funcionando en modo offline: el controlador utiliza reglas de acceso almacenadas en caché local para aprobar o denegar la entrada. Una vez que la conexión API se restablece, La puerta sincroniza automáticamente los registros de eventos y cualquier actualización de credenciales. Este respaldo fuera de línea es esencial para instalaciones que no pueden aceptar inactividad de puerta durante interrupciones de red.
Iniciando tu integración
El camino correcto de integración se reduce a tres opciones: Tu tipo de software (En la nube o en las instalaciones), Tu tipo de credencial (Código QR, RFID, biométrico), y la escala de tu instalación. Ironman proporciona un paquete completo de SDK — placa de interfaz, Documentación del protocolo, Referencia de API, y ejemplos de código — con órdenes confirmadas de puerta, además de soporte directo de TI durante las pruebas.
El mercado global de control de acceso está creciendo en 4.08% CAGR, con los sistemas de puertas de torniquetes en el centro de los despliegues de seguridad empresarial. Conseguir la integración de software correctamente desde el primer día protege esa inversión a largo plazo.
Solicita tu paquete SDK y especificaciones del proyecto contactando con el equipo de Ironman a través de nuestroPuertas de torniquetes al por mayor y página de proyectos. Incluye el requisito de tu modelo de puerta, Tipo de credencial, y plataforma de software objetivo — y esperar una respuesta técnica dentro de 12 Horario de atención.
