Appearance
credenciales-invalidas
urn:auditium:api:error:credenciales-invalidas| HTTP | 401 |
title | Credenciales inválidas / Token inválido |
La credencial llegó, pero no sirve. Cubre los dos casos: usuario y contraseña que no validan en login, y token inválido o vencido en el resto de los endpoints.
El detail no indica si el problema es el usuario, la contraseña o el estado de la cuenta.
Causa típica
En login:
- Usuario o contraseña incorrectos.
- Usuario vencido o dado de baja.
- Contraseña con caracteres que el cliente HTTP escapó mal al armar el
Basic.
En el resto de los endpoints:
- El token venció. Duran 90 minutos.
- El token fue invalidado con
logout. - El token está truncado o tiene espacios de más.
Cómo resolverlo
Si el error aparece usando un token, pedir uno nuevo:
bash
TOKEN=$(curl -s -X POST -u "$AUDITIUM_USER:$AUDITIUM_PASS" \
https://auditium.com.ar/ruc/api/login | jq -r .access_token)Para evitar el caso más habitual, guardar el momento de emisión junto con expires_in y renovar antes de que queden menos de 2 minutos de vida. Llamar a login con un token todavía vigente devuelve el mismo token, así que la renovación preventiva es segura.
Si el error aparece en login, verificar las credenciales con el contacto técnico: no hay reintento que lo resuelva.
Ejemplo
json
{
"type": "urn:auditium:api:error:credenciales-invalidas",
"title": "Token inválido",
"status": 401,
"detail": "El token enviado no es válido o ya venció.",
"instance": "/ruc/api/asignaciones_personal?id_comitente=9999",
"_links": [
{ "href": "https://developers.auditium.com.ar/errores/credenciales-invalidas", "rel": "help", "method": "GET" }
]
}La respuesta incluye WWW-Authenticate, con error="invalid_token" cuando el esquema es Bearer.
Relacionados
credenciales-ausentes— no llegó el header.- Autenticación