Un único contrato para todos los dispositivos. 38 operaciones en cinco grupos de capacidades, disponibles como llamadas REST síncronas y webhooks Callback en tiempo real.
Todas las llamadas REST se dirigen a un único host versionado.
https://api.camsbiometrics.com/v3/
Cada solicitud lleva AuthToken asociada a tu cuenta y dispositivo. Las claves se emiten desde el portal para desarrolladores.
Solicitudes codificadas como formulario o en JSON. Las respuestas son JSON con campos y códigos de error predecibles.
Dos formas de integrar
Llamas al gateway y obtienes una respuesta inmediata. Perfecto para consultar asistencia, listar usuarios, registrar a alguien o abrir una puerta bajo demanda.
Registra una URL y el gateway te envía los eventos en el instante en que un dispositivo los notifica: sin polling y con reintentos automáticos en caso de fallo.
Operaciones
Agrupadas según su función. Los nombres se corresponden 1:1 con los endpoints del gateway.
Todos los fichajes dentro de un intervalo de fechas en toda la cuenta.
Registros de un solo código de empleado durante un periodo.
Fichajes capturados por un dispositivo según su número de serie.
Resumen por día y por empleado (entrada/salida, horas).
Par primera entrada / última salida por empleado y día.
Instantánea en vivo de los fichajes de hoy.
Fotos capturadas asociadas a un fichaje, cuando el dispositivo lo admite.
Exportación masiva para nómina y conciliación.
Crea un usuario en uno o varios dispositivos.
Edita nombre, rol, vigencia o privilegios.
Elimina un usuario de un dispositivo.
Busca un usuario por código, con credenciales opcionales.
Enumera a todos los usuarios registrados en un dispositivo.
Muestra en qué dispositivos existe un usuario.
Envía una plantilla de huella al dispositivo.
Registra una plantilla facial, cuando el dispositivo lo admite.
Asigna una tarjeta RFID / de proximidad a un usuario.
Establece o cambia un PIN / contraseña del dispositivo.
Clona usuarios y plantillas entre dispositivos.
Vuelve a entregar los datos de un usuario a la cola de un dispositivo.
Activa un relé de puerta, torniquete, barrera abatible, batiente o de brazo en tiempo real.
Bloquea o mantiene cerrada una puerta bajo tu control.
Lee el estado actual, abierta o cerrada.
Define franjas horarias de acceso.
Registro de eventos de entrada / salida y de puertas.
Inventario de todos los dispositivos conectados.
Modelo, firmware, capacidad y contadores.
Estado en línea, última conexión y profundidad de la cola.
Confirma ahora si un dispositivo es accesible.
Sincroniza el reloj del dispositivo con el servidor.
Reinicia un dispositivo de forma remota.
Elimina de la cola los comandos bloqueados.
Sigue el estado de un comando en cola.
Suscribe una URL de webhook para recibir eventos en vivo.
Se dispara con cada fichaje, en tiempo real.
Transiciones de conexión / desconexión y de estado.
Confirmación cuando una plantilla llega a un dispositivo.
Sigue el progreso de migraciones masivas de dispositivos / datos.
Respuestas predecibles
| Código | Significado | Qué hacer |
|---|---|---|
200 | Correcto | Procesa el payload JSON. |
401 | AuthToken no válido o ausente | Comprueba la clave de API y la vinculación del dispositivo. |
404 | Dispositivo o usuario no encontrado | Verifica el número de serie / código de empleado. |
409 | Dispositivo sin conexión / en cola | El comando queda en cola; consulta GetCommandStatus. |
429 | Límite de solicitudes superado | Espera y reintenta con jitter. |
La guía de inicio rápido te lleva en minutos desde la clave de API hasta tu primer registro de asistencia.
Usamos cookies para medir el tráfico y mejorar BiometricAPI.com. La analítica permanece desactivada hasta que aceptes. Más información.