Inicio / Productos / API / Biometric Gateway Web API
API

Biometric Gateway Web API

La Biometric Gateway Web API (también conocida como Universal Biometric Web API 3.0) convierte cualquier dispositivo compatible de huella, rostro, palma, venas, iris, retina, tarjeta o contraseña en un endpoint conectado a la nube con el que tu aplicación puede comunicarse desde cualquier lugar del mundo. Recibe los fichajes en tiempo real en el mismo instante en que ocurren y gestiona los usuarios del dispositivo de forma remota, todo mediante un contrato sencillo de REST más Callback.

Descripción general

Conecta cualquier dispositivo biométrico de asistencia o control de acceso con acceso a internet directamente a tu aplicación web por HTTP, sin software local, PC ni base de datos.

La Web API insignia de Cams permite la comunicación de máquina a servidor entre dispositivos biométricos instalados de forma remota y la aplicación de tu servidor. Un dispositivo se conecta a internet, la asistencia se envía en tiempo real a tu URL de Callback (webhook) y tu servidor controla operaciones del dispositivo como añadir o eliminar usuarios, enviar plantillas, enviar fotos y cargar registros de fichajes mediante llamadas RESTful. No hace falta instalar software de escritorio, mantener una base de datos local ni tener un PC en la LAN. La API es independiente de la base de datos y funciona con cualquier lenguaje de backend.

APIRESTCallback/Webhook (HTTP POST)MQTT (ruta de conexión persistente EMQX)PHPPythonJavaNode.js
Callback (webhook) — fichaje en tiempo real
# Your Callback URL receives every punch in real time
POST https://yourapp.com/cams/callback
{
  "DeviceSN": "SN7A2300583",
  "EmployeeCode": "1042",
  "AttendanceLog": "2026-06-21 09:02:14",
  "Type": "face",
  "Direction": "CheckIn"
}

Capacidades

Qué hace

Asistencia en tiempo real

Los fichajes se envían a tu URL de Callback en el momento en que se registran en el dispositivo.

Gestión remota de usuarios

Añade, elimina, bloquea y mueve usuarios, y envía plantillas o fotos a los dispositivos desde tu servidor mediante llamadas RESTful.

Captura multimodal

Un único contrato gestiona entradas de huella, rostro, palma, venas, iris, retina, tarjeta y contraseña.

Resiliencia sin conexión

Los fichajes sin conexión se almacenan en el búfer del dispositivo y se reproducen en orden cuando se restablece la conectividad.

Transporte cifrado

El cifrado AES-256 de los datos sin procesar se puede habilitar por dispositivo para un intercambio seguro de datos.

Funciones

Todo incluido

  • La API de Callback (webhook) entrega los fichajes de asistencia en tiempo real del dispositivo a tu servidor, sin latencia de polling
  • API RESTful para operaciones del servidor al dispositivo: Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog y más (38 operaciones)
  • Captura varios tipos de entrada por fichaje: huella, rostro, tarjeta, palma, venas del dedo, iris, retina, contraseña, además de indicadores de temperatura corporal y mascarilla cuando el hardware lo admite
  • Los tipos de fichaje incluyen CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
  • Gestiona los fichajes sin conexión: los datos en cola se transmiten en secuencia cuando el dispositivo se reconecta
  • Cifrado AES-256 opcional de todos los datos sin procesar intercambiados, con una clave de seguridad definida en API Monitor
  • La LoadLog API permite que las aplicaciones sin servidor y solo LAN obtengan a demanda hasta 30 días de historial de asistencia
  • Códigos de estado documentados para una gestión de errores sólida, con AuthToken por dispositivo y trazabilidad con OperationID para soporte y conciliación

Desarrolla con Biometric Gateway Web API

Consigue una clave, lee la documentación y publica. Nuestro equipo te ayuda con tu primera integración.

Preguntas frecuentes

Preguntas frecuentes

¿Necesito instalar algún software en mi red local para usar la Web API?

No. La comunicación se realiza por HTTP entre el dispositivo y tu servidor. Mientras el dispositivo esté conectado a internet, puedes recibir asistencia y gestionar usuarios sin software local, base de datos ni PC.

¿Qué entradas biométricas admite la Web API?

Huella, rostro, tarjeta, palma, venas del dedo, iris, retina y contraseña, además de datos de temperatura corporal y mascarilla cuando el hardware los proporciona.

¿Cuál es la diferencia entre la API de Callback y la API RESTful?

La API de Callback es la comunicación en tiempo real del dispositivo al servidor mediante una URL que expones en tu servidor (sin latencia). La API RESTful es la comunicación del servidor al dispositivo que llamas en el endpoint de Cams para gestionar el dispositivo, con una latencia de hasta unos 15 segundos.

¿Puedo usar la API si mi servidor no tiene IP pública?

Sí. Usa la LoadLog API para obtener a demanda los registros de asistencia de un periodo determinado, siempre que el dispositivo esté conectado a internet.

Relacionado

Explora más de la plataforma