Login — Obtener token JWT

Autentica un usuario con credenciales. Devuelve un par de tokens access y refresh.

POSThttps://dev.backend.colurs.co/token/

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]

request.json{
"username": "usuario@ejemplo.com",
"password": "Password123!",
"platform": "API"
}

curl -X POST https://dev.backend.colurs.co/token/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "x-api-key: [API_KEY]" \
-d '{
  "username": "usuario@ejemplo.com",
  "password": "Password123!",
  "platform": "API"
}'

{
"access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"refresh": 
"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."}

{
"code_transaction": "OTPRequiredException",
"message": 
"Se requiere código OTP"}

{
"code_transaction": "CodeMustBeRequiredException",
"message": 
"Se requiere código de verificación"}

{
"code_transaction": "CodeExpiredException",
"message": 
"El código de verificación ha expirado"}

Usar el token

Incluye estos headers en cada petición autenticada:

Content-Type: application/json
Accept: application/json
x-api-key: [API_KEY]
Authorization: Bearer [ACCESS_TOKEN]

Flujo con 2FA (MFA)

Si el usuario tiene autenticación de dos factores habilitada (totp_secret en su perfil), el login requiere un paso adicional:

1. Envía username, password y platform normalmente.
2. El servidor responde con OTPRequiredException.
3. Reenvía la misma petición agregando el campo otp con el código de 6 dígitos del autenticador.
4. Si el OTP es válido, recibes los tokens.

Plataformas soportadas