Introducción
Cams Biometric Gateway — Web API 3.0
El Cams Biometric Gateway es la API biométrica universal que conecta cualquier equipo biométrico de asistencia o control de acceso con su aplicación: ERP, HRMS, nómina, gestión escolar, software a medida o flujos de trabajo de IA/automatización. Es compatible con las principales marcas de dispositivos y ofrece una API biométrica JSON sobre HTTP estandarizada, sin importar el hardware.
38 operaciones: 11 APIs de callback (Dispositivo → Servidor) y 27 APIs RESTful (Servidor → Dispositivo). Todos los payloads son JSON sin procesar sobre HTTP/HTTPS.
Se admiten todos los equipos biométricos. Equipos Cams, dispositivos verificados y marcas de terceros (ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime/Startek, Biomax, Secugen, eSSL, Matrix COSEC y más). Elija el
modo de conexión que mejor se adapte a su entorno.
Cómo funciona
El Biometric Gateway se compone de:
Servidor GatewayPlataforma alojada en la nube que incluye el Cams Protocol Engine (traducción de protocolos, normalización de datos, caché sin conexión, autenticación) y la capa de API estandarizada que ofrece una interfaz coherente a su aplicación.
Protocol EngineEl motor central del servidor Gateway que se comunica con los dispositivos biométricos, traduce los protocolos propios de cada fabricante y gestiona el registro seguro de transacciones de datos y la gestión de identidades.
Protocol Engine LiteVersión local que puede instalarse en su propio servidor (Windows/Linux) para entornos solo LAN o autoalojados. La misma API, desplegada localmente.
Se integra con
OdooERPNextSAPMicrosoft Dynamics
ZohoBitrix24
OrangeHRMBayZatPalmHRuKnowva
FedenaTeachmintEduBricz
RazorPayPayruler
n8nMakeZapier
Claude (MCP)GeminiChatGPT
Aplicaciones web a medida
Su aplicación
ERP
HRMS
Payroll
ERP escolar
Flujo de trabajo con IA (n8n, Zapier)
MCP — Claude · Gemini · ChatGPT
Aplicaciones a medida
Protocol Engine
Procesamiento seguro de autenticación
Registro de transacciones de datos
Traducción de protocolos
Caché sin conexión y cola
Cifrado AES-256 · Validación de AuthToken
Capa de API estandarizada
Gestión de identidades
Integración con IA / MCP
Despachador de callbacks
Enrutador de comandos REST
Normalización de datos · Compatibilidad con protocolos de múltiples marcas
Huella dactilar
·
Reconocimiento facial
·
Venas de la palma
·
Tarjeta RFID
·
PIN
·
QR / Código de barras
·
Seguimiento GPS
Dispositivos biométricos — Todas las marcas compatibles
Cams
ZKTeco
Suprema
Hikvision
Anviz
Morpho / IDEMIA
Virdi
Mantra
Nitgen
Realtime
Biomax
Secugen
eSSL
Matrix
+ Muchas más
| Tipo de API | Dirección | Latencia | Caso de uso |
|---|
| API de callback | Dispositivo → Su servidor | Tiempo real / latencia cero | Recibir marcaciones de asistencia y eventos de sincronización de usuarios |
| API RESTful | Su servidor → Dispositivo | ~15 segundos | Agregar/eliminar usuarios, cargar registros, registrar datos biométricos |
Introducción
Primeros pasos
Integre en tres pasos. Su servidor necesita una URL accesible públicamente para recibir los callbacks.
1
Configure su URL de callback
Inicie sesión en el portal API Monitor. Establezca la URL HTTPS pública de su servidor como URL de callback de sus dispositivos. El motor de la API enviará (POST) los eventos biométricos a este endpoint en tiempo real.
2
Reciba las marcaciones de asistencia
Su endpoint recibe un POST con un cuerpo JSON sin procesar; las APIs de callback no necesitan parámetros de consulta. Valide el AuthToken, procese los datos de la marcación y responda con {"status":"done"}.
3
Llame a las APIs RESTful para gestionar usuarios y dispositivos
Envíe (POST) un comando JSON a la URL del endpoint RESTful que figura en su cuenta de API Monitor, con su stgid (Service Tag ID) como parámetro de consulta. El motor pone el comando en cola y el dispositivo lo confirma en unos ~15 segundos.
Formato del endpoint
| Tipo de API | Método | Cómo enviar |
|---|
| API de callback (entrante) |
POST |
El dispositivo envía a su URL configurada. Cuerpo JSON sin procesar; sin parámetros. |
| API RESTful (saliente) |
POST |
Usted envía (POST) a la URL del endpoint RESTful (que figura en su cuenta de API Monitor) con ?stgid=YOUR_SERVICE_TAG_ID y un cuerpo JSON sin procesar. |
Responda siempre de inmediato a las solicitudes de callback. Su servidor debe devolver {"status":"done"} (HTTP 200) para confirmar la recepción. No realice procesamientos pesados antes de responder: póngalos en cola.
Documentación
Documentación de la API
La referencia está dividida por temas. Empiece por la compatibilidad de dispositivos y luego siga con las operaciones de callback y REST.
Dispositivos compatibles y modos de conexiónQué equipos admite el Gateway, cómo se conecta cada uno (Native Push o Hybrid Push) y qué operaciones de la API están disponibles en cada modo.
Referencia de la API: arquitectura, campos y códigos de estadoLos componentes comunes a todas las operaciones: flujo de solicitudes, campos JSON comunes, tipos de plantilla, códigos de estado, puertos y cifrado del payload.
APIs de callback: eventos en tiempo real del dispositivo a su servidorTodos los eventos que un dispositivo envía a su URL de callback, con el JSON que recibe su servidor y la respuesta que debe devolver.
APIs RESTful: comandos de su servidor al dispositivoComandos que su servidor envía a un dispositivo a través del Gateway, con el JSON de solicitud y respuesta de cada uno.
Pruebas locales de la APICómo recibir callbacks de dispositivos en un equipo de desarrollo y probar los comandos REST con Postman antes de pasar a producción.
Ejemplo en PHP: almacenar asistencia biométrica en MySQLUn controlador de callback en PHP funcional que guarda las marcaciones de asistencia en MySQL, en tres pasos.
Prompts de IA para generar códigoCopie un prompt en su asistente de IA para generar el código de integración para su propia pila tecnológica.
Preguntas frecuentes, SDK y costoPreguntas habituales de los integradores, además de cómo funcionan el SDK y los precios de la API.
