Marca por PIN

Desarrollando

Entorno desarrollo

https://dev-api.talentify.cr

POST

/api/tempo/quiosco/pin

Registra una marca de asistencia validando la identidad de la persona mediante un PIN único, en lugar del reconocimiento facial. Es la alternativa recomendada cuando la cámara no está disponible o cuando la persona aún no tiene un expediente facial registrado.

El PIN se genera previamente con el endpoint Generar PIN y pertenece a una persona específica. Junto con el PIN se envían las coordenadas actuales y el código de la ubicacion de destino para validar la cercanía geográfica.

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

Solicitud

Autorización

Bearer Token

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

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

Parámetros de Header

Parámetros del Body multipart/form-data

Respuestas

🟢200Éxito

application/json

Resultado del intento de marca por PIN, con los datos de la persona identificada y la validación de cercanía geográfica.

Bodyapplication/json

🟠422Datos incompletos

🟠422El PIN no existe

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://dev-api.talentify.cr/api/tempo/quiosco/pin' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--form 'pin="2233"' \
--form 'latitud="9.912065"' \
--form 'longitud="-84.065309"' \
--form 'ubicacion="929-6558-166"' \
--form 'tipo="e"' \
--form 'naturaleza="l"'

Ejemplo de Respuesta

200 - Marca registrada

{
    "exito": true,
    "marca": {
        "id": 103723,
        "hora": "07:58",
        "dia": "25/10/2024",
        "persona": {
            "id": 1382,
            "nombre": "Sebastián",
            "primerApellido": "Calero",
            "segundoApellido": "Sánchez"
        },
        "horaEntrada": "08:00",
        "horaSalida": "17:00",
        "tipo": "e",
        "naturaleza": "l",
        "minutosDiferencia": 2,
        "inconsistencia": false,
        "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": true,
        "distanciaDeAlejamiento": 12,
        "aprobada": true,
        "manual": false,
        "bloqueada": false,
        "analisisFacial": null
    }
}

Modificado en 2026-07-02 18:44:51

Detalle de ubicación

Generar PIN

Marca por PIN

Tipos de marca (tipo)#

Naturaleza de la marca (naturaleza)#

Solicitud

Respuestas

Tipos de marca (`tipo`)

Naturaleza de la marca (`naturaleza`)