Marca facial

Registra una marca de asistencia (entrada, salida o receso) en modo quiosco, validando la identidad de la persona mediante reconocimiento facial y verificando su ubicación geográfica respecto a la sucursal de destino.

Modo quiosco

En el modo quiosco, un único dispositivo compartido (tablet, tótem o terminal) atiende a todas las personas de una sucursal. Cada colaborador se autentica frente a la cámara y el sistema lo identifica comparando su rostro contra los expedientes faciales de la unidad de negocio.

La marca se asocia a una ubicación de destino identificada por su código de establecimiento (formato ###-####-###), que se envía en el campo ubicacion. El sistema compara la posición declarada con esa ubicación para validar la cercanía.

Tipos de marca (`tipo`)

Valor	Significado
`e`	Entrada
`s`	Salida

Naturaleza de la marca (`naturaleza`)

Valor	Significado
`l`	Jornada laboral
`a`	Almuerzo
`rm`	Receso en la mañana
`rt`	Receso en la tarde

Imagen

El campo imagen se envía como una cadena Base64 del fotograma capturado. La respuesta es un objeto de reconocimiento (RespuestaReconocimiento) que incluye el resultado (exito), los datos de la persona, las emociones detectadas, el porcentaje de similitud, la validación de cercanía (dentroDelRadio, distanciaAlPunto) y, si todo procede, la marca registrada.

Bearer Token

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Respuestas

🟢200Éxito

application/json

Resultado del intento de marca facial. Incluye si la operación fue exitosa (exito), los datos de la persona reconocida, las emociones detectadas, el porcentaje de similitud y la validación de cercanía geográfica.

Bodyapplication/json

🟠422Datos incompletos

🟢200Persona no reconocida

curl --location 'https://dev-api.talentify.cr/api/tempo/quiosco/facial' \ --header 'Accept: application/json' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "tipo": "s", "naturaleza": "l", "ubicacion": "179-2511-681", "latitud": null, "longitud": null, "imagen": "{{base64_cliente}}" }'

{ "exito": true, "persona": { "id": 1382, "nombre": "Sebastían", "primerApellido": "Calero", "segundoApellido": "Sánchez", "identificacion": "848747747" }, "emocionPrimaria": "SURPRISED", "emocionSecundaria": "CONFUSED", "similitud": 99.9971694946289, "dentroDelRadio": false, "distanciaAlPunto": 68.1113221291898, "errores": [] }

Modo quiosco#

Tipos de marca (tipo)#

Naturaleza de la marca (naturaleza)#

Imagen#

Solicitud

Respuestas

Modo quiosco

Tipos de marca (`tipo`)

Naturaleza de la marca (`naturaleza`)

Imagen