Autentificar por ubicación

Desarrollando

Entorno desarrollo

https://dev-api.talentify.cr

POST

/api/tempo/quiosco/establecer

Autentica un quiosco y lo vincula a una ubicación concreta. Es el primer paso de la operación en modo quiosco: una vez establecida la ubicación, el dispositivo puede recibir marcas de cualquier colaborador mediante reconocimiento facial.

Se indica la unidad de negocio y el código de ubicacion (###-####-###). La respuesta devuelve un token que debe usarse como Bearer token en las marcas posteriores realizadas desde ese quiosco, junto con los datos de la ubicación y de la unidad de negocio.

Este endpoint es público: no requiere un token previo, ya que su propósito es emitir el token del dispositivo.

Si la unidad y la ubicación son válidas pero no es posible emitir el token, la API responde 406 Not Acceptable.

Solicitud

Autorización

Parámetros de Header

Parámetros del Body application/json

Ejemplos

Respuestas

🟢200Autentificación correcta

application/json

El quiosco quedó autenticado en la ubicación indicada. El token devuelto debe enviarse como Bearer token en las marcas posteriores; se incluyen también los datos de la ubicacion y de la unidadNegocio.

Bodyapplication/json

🟠422Datos incompletos

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://dev-api.talentify.cr/api/tempo/quiosco/establecer' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "unidad": 181,
    "ubicacion": "931-0805-747"
}'

Ejemplo de Respuesta

200 - Success

{
    "token": "LNZCMErKVfhWhwHG21p53IZsZIp6",
    "ubicacion": {
        "id": 3031,
        "nombre": "San Carlos Business Center",
        "latitud": "0",
        "longitud": "0",
        "direccion": "San Carlos Business Center.",
        "pais": "CRC",
        "provincia": "1",
        "canton": "1",
        "distrito": "1",
        "nombreProvincia": "San José",
        "nombreCanton": "San José",
        "nombreDistrito": "Carmen",
        "radioDeTolerancia": 50,
        "codigoEstablecimiento": "123-4567-890"
    },
    "unidadNegocio": {
        "id": 181,
        "nombre": "Ensensis SA",
        "administrador": {
            "id": 25,
            "persona": 3,
            "nombre": "Manfred",
            "primerApellido": "Juárez",
            "segundoApellido": "",
            "correoElectronico": "prueba@prueba.com",
            "nacionalidad": "CRC",
            "tipoIdentificacion": "01",
            "identificacion": "433750946"
        },
        "casaMatriz": true,
        "identificacionJuridica": "3-101-660338",
        "plan": {
            "estado": "activo",
            "pagoAutomatico": true
        },
        "logo": {
            "id": 3121,
            "nombre": "3-101-66044.png",
            "directorio": "unidad/181/logo/3-101-66448.png",
            "mime": "image/png",
            "extension": "png",
            "version": 1,
            "categorias": [],
            "fechaRegistro": "05/06/2025"
        }
    },
    "errores": [],
    "parametros": {
        "fotos": "https://dev-talentify.twic.pics"
    }
}

Modificado en 2026-06-10 23:59:01

Generar PIN

Marca Face liveness