Token

Entorno desarrollo

https://dev-api.talentify.cr

POST

/api/token

Este endpoint permite a los usuarios o aplicaciones externas autenticarse en el sistema. Su finalidad es validar las credenciales del usuario (correo y contraseña) y, si son correctas, emitir una cadena de texto única (Token) que servirá como llave de acceso temporal.

Este token es obligatorio para realizar peticiones a los demás endpoints protegidos de la API.

Cómo utilizar el Token en otros Endpoints

Una vez que has obtenido el string del token mediante el endpoint /api/token, debes incluirlo en los encabezados (headers) de todas las futuras solicitudes HTTP a rutas protegidas.

Se utiliza el esquema de Bearer Token.

Estructura del Header

Debes agregar la siguiente clave y valor en tus peticiones:

Key: Authorization
Value: Bearer <TU_TOKEN_AQUI>

Nota: Es importante incluir el espacio entre la palabra "Bearer" y el string del token.

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 application/json

Ejemplos

Respuestas

🟢200Éxito

application/json

Credenciales válidas. Devuelve el token de acceso y si la cuenta requiere doble factor de autenticación. El token se entrega también como cookie de sesión.

Bodyapplication/json

🟠401Credenciales incorrectas

🟠422Datos incompletos

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

cURL

1Solicitar token

curl --location 'https://dev-api.talentify.cr/api/token' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "correo": "{{correo}}",
    "contrasena": "{{contrasena}}",
    "dispositivo": "API"
}'

Ejemplo de Respuesta

200 - Success

{
    "token": "8|Xy3Z...tokenDeEjemplo",
    "2FA": false
}

Modificado en 2026-06-13 01:30:10

Entidades incapacidad

Cuenta

Token

Cómo utilizar el Token en otros Endpoints#

Estructura del Header#

Solicitud

Respuestas

Cómo utilizar el Token en otros Endpoints

Estructura del Header