HTTP Attendance API

La entrada HTTPS única para cualquier cliente que genere asistencia. La HTTP Attendance API autentica por número de serie de dispositivo y token, y canaliza cada fichaje reconocido al mismo pipeline de almacenamiento y envío al cliente que todos los motores nativos de Cams.

Empezar Documentación para desarrolladores

Descripción general

Una puerta de entrada HTTPS independiente del dispositivo para recibir fichajes de asistencia, heartbeats y comprobaciones de suscripción de cualquier cliente.

La HTTP Attendance API es la puerta de entrada independiente del dispositivo en la ruta /api/attendance/v1/{op}. Autentica cada solicitud mediante las cabeceras de número de serie del dispositivo (sn) y auth-token, y después ingiere los datos. Expone punch (un evento de asistencia reconocido), heartbeat (presencia del dispositivo), validity (comprobación de suscripción) y config. Los fichajes se canalizan al pipeline compartido, con el mismo almacenamiento y envío posterior al servidor del cliente que los transportes nativos HTTP, TCP y MQTT, de modo que las integraciones se mantienen coherentes sea cual sea la forma en que llegue la asistencia.

APIRESTHTTPSJSONC++

Se usa en:Escuelas, universidades y campus

POST /api/attendance/v1/punch

curl https://api.camsbiometrics.com/api/attendance/v1/punch \
  -H "sn: SN7A2300583" -H "auth-token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "user_id":"1001", "att_time":"2026-06-21 09:30:00",
        "att_state":1, "input_type":50 }'
# -> 200 {"ok":true}

Capacidades

Qué hace

Ingerir un fichaje

Envía con POST un evento de asistencia reconocido con usuario, marca de tiempo, estado de entrada/salida, tipo de entrada y ubicación opcional.

Informar de la presencia

Envía un heartbeat para marcar un dispositivo como en línea, sin cuerpo alguno.

Comprobar la vigencia

Consulta si la suscripción de asistencia del dispositivo está activa antes de enviar datos.

Pipeline unificado

Cada fichaje llega al mismo almacenamiento y ruta de envío que la ingesta nativa por TCP y MQTT.

Funciones

Todo incluido

Entrada HTTPS única para clientes edge, de app, web e híbridos en /api/attendance/v1/{op}
Autenticación por cabeceras: número de serie del dispositivo (sn) más auth-token, con control de acceso por suscripción
El endpoint punch ingiere un evento de asistencia reconocido (usuario, hora, entrada/salida, tipo de entrada, geolocalización opcional)
El endpoint heartbeat marca un dispositivo como en línea para el seguimiento de presencia
El endpoint validity devuelve el estado de la suscripción en vivo antes de que un cliente envíe datos
Pipeline compartido: mismo almacenamiento y envío al servidor del cliente que los motores nativos
Contrato de errores JSON coherente para número de serie ausente, dispositivo desconocido, token no válido o suscripción inactiva
Detrás de nginx, con límites de tamaño del cuerpo y limitación de tasa

Desarrolla con HTTP Attendance API

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

Habla con un ingeniero WhatsApp

Preguntas frecuentes

¿Qué hace la HTTP Attendance API?

Es la puerta de entrada independiente del dispositivo que acepta fichajes de asistencia reconocidos, heartbeats y comprobaciones de suscripción, los autentica por número de serie del dispositivo y token, y los incorpora al pipeline de asistencia compartido de Cams.

¿Cómo se autentican las solicitudes?

Cada solicitud lleva una cabecera con el número de serie del dispositivo (sn) y otra con el auth-token; ambas deben ser válidas. Los endpoints biométricos exigen además una suscripción de asistencia activa.

¿La asistencia por HTTP se trata igual que la de los dispositivos?

Sí. Los fichajes se canalizan al mismo pipeline que usan los motores nativos HTTP, TCP y MQTT, por lo que el almacenamiento y el envío posterior son idénticos sea cual sea el transporte.