Marca Face liveness

Registra una marca de asistencia a partir del resultado de un análisis de Face Liveness (prueba de vida), verificando además la ubicación geográfica respecto a la sucursal de destino.

A diferencia de la marca facial simple, aquí el reconocimiento y la prueba de vida se realizan en el cliente (por ejemplo, con AWS Rekognition Face Liveness) y el resultado se envía en el campo liveness como metadatos. El backend confía en ese análisis para identificar a la persona y registrar la marca.

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

Respuestas

🟢200Marca registrada

application/json

La marca se registró correctamente a partir del análisis de Face Liveness. Se devuelve el detalle completo de la marca generada: hora, tipo, naturaleza, ubicación de destino, validación de cercanía y estado de aprobación.

Bodyapplication/json

🟠422Datos incompletos

curl --location 'https://dev-api.talentify.cr/api/tempo/quiosco/liveness' \ --header 'Accept: application/json' \ --header 'Accept: application/json' \ --form 'persona="3"' \ --form 'latitud="9.912065"' \ --form 'longitud="-84.065309"' \ --form 'ubicacion="123-4567-890"' \ --form 'tipo="e"' \ --form 'naturaleza="l"' \ --form 'liveness="{\"facial_analysis\":{\"RekognitionStatus\":\"MATCH_FOUND\",\"TransactionId\":\"71b88fbd-58b6-498a-80b5-c738c05a13d2\",\"TimestampEpoch\":1774572946,\"AnalysisError\":null,\"PosePitch\":2.0531837940216064,\"FaceAnalysisPresent\":true,\"MouthOpenConfidence\":96.61994171142578,\"ProcessingStatus\":\"COMPLETED\",\"PrimaryEmotion\":\"CONFUSED\",\"EyeglassesConfidence\":99.75200653076172,\"status\":\"completed\",\"SecondaryEmotion\":\"ANGRY\",\"SecondaryEmotionConfidence\":24.8291015625,\"MustacheConfidence\":85.28803253173828,\"QualitySharpness\":60.49041748046875,\"Sunglasses\":false,\"Mustache\":true,\"AgeRangeLow\":34,\"ImageSourceType\":\"S3\",\"ImageS3Bucket\":\"ensensis-analytics-dev-us-east-1-475917795531-stage\",\"ImageS3Key\":\"tmpfaces/20260327/181/962845d2-62e3-4de2-bb04-6a37aa577180/reference.jpg\",\"EyesOpenConfidence\":97.88819885253906,\"QualityBrightness\":82.0064926147461,\"DetectedFaceDetailsForSearch\":null,\"UnmatchedReason\":null,\"ExecutionTimeMs\":507.75647163391113,\"AgeRangeHigh\":42,\"SunglassesConfidence\":99.53614044189453,\"GenderConfidence\":99.94518280029297,\"PoseYaw\":-28.906808853149414,\"MatchedPersonId\":\"3\",\"MatchedBoundingBox\":{\"Height\":0.5006250143051147,\"Left\":0.24059000611305237,\"Top\":0.26300400495529175,\"Width\":0.46126100420951843},\"BeardConfidence\":99.5726318359375,\"Eyeglasses\":false,\"PoseRoll\":-6.866798400878906,\"Similarity\":99.99827575683594,\"Beard\":true,\"DetectedBoundingBox\":{\"Height\":0.6240252256393433,\"Left\":0.3022521436214447,\"Top\":0.20255568623542786,\"Width\":0.3344934582710266},\"MatchedFaceId\":\"e3c7f6a8-f9a5-44e1-affc-2928b224397a\",\"Gender\":\"Male\",\"PrimaryEmotionConfidence\":65.7275390625,\"EyesOpen\":true,\"FaceConfidence\":99.9999008178711,\"ProcessedAtCostaRica\":\"2026-03-26T18:55:46-06:00\",\"MouthOpen\":false,\"SmileConfidence\":99.70458984375,\"Smile\":false,\"UsedCollectionId\":\"181_Faces\"},\"ppe_detection\":null,\"custom_labels\":null,\"location_service\":{\"GeofenceStatus\":\"ERROR_VALIDATION\",\"TimestampEpoch\":1774572946,\"TargetGeofenceId\":\"VMG Business Center\",\"TargetCollection\":\"181\",\"ProcessingStatus\":\"COMPLETED\",\"Longitude\":-84.065773,\"Latitude\":9.912349,\"ProcessedAtCostaRica\":\"2026-03-26T18:55:46-06:00\",\"IsCompliant\":false,\"TotalGeofencesChecked\":1,\"TransactionId\":\"71b88fbd-58b6-498a-80b5-c738c05a13d2\"}}"' \ --form 'ruta=""' \ --form 'observaciones=""'

{ "marca": { "id": 103723, "hora": "21:42", "dia": "20/03/2026", "persona": { "id": 3, "nombre": "Manfred", "primerApellido": "Juárez", "segundoApellido": "" }, "horaEntrada": "08:00", "horaSalida": "17:00", "tipo": "e", "naturaleza": "l", "minutosDiferencia": 822, "inconsistencia": true, "latitud": "9.912065", "longitud": "-84.065309", "ubicacionDestino": { "id": 301, "nombre": "VMG Business Center", "latitud": "0", "longitud": "0", "direccion": "Escazú", "pais": "CRC", "provincia": "1", "canton": "1", "distrito": "1", "nombreProvincia": "San José", "nombreCanton": "San José", "nombreDistrito": "Carmen", "radioDeTolerancia": 50, "codigoEstablecimiento": "123-4567-890" }, "cumpleCercania": false, "distanciaDeAlejamiento": 0, "aprobada": false, "manual": true, "bloqueada": false, "analisisFacial": null } }

Tipos de marca (tipo)#

Naturaleza de la marca (naturaleza)#

Solicitud

Respuestas

Tipos de marca (`tipo`)

Naturaleza de la marca (`naturaleza`)