{
"code": "<error_code>",
"title": "<error_title>",
"message": "<error_message>"
}
code– un identificador estable y único para el error. Útil para el manejo programático y las solicitudes de soporte.title– un resumen breve y legible del problema.message– una guía detallada para ayudarte a resolver el error.
Errores de Auth
Los siguientes errores pueden ocurrir al interactuar con los endpoints de las Auth APIs. Cada error sigue nuestra estructura estándar.
400
code | title | message |
|---|---|---|
| AUT-0001 | Campos faltantes en la solicitud | A tu solicitud le faltan uno o más campos obligatorios. Consulta la documentación para confirmar que se incluyan todos los campos necesarios en tu solicitud. |
| AUT-0002 | Parámetro de ruta no válido | Uno o más parámetros de ruta tienen un formato incorrecto. Revisa los siguientes parámetros y confirma que cumplan con el formato requerido antes de volver a intentarlo. |
| AUT-0003 | Campos inesperados en la solicitud | El cuerpo de la solicitud contiene más campos de los esperados. Envía solo los campos permitidos según la documentación. Los campos inesperados se enumeran en el objeto fields. |
| AUT-0004 | Parámetro de consulta no válido | Uno o más parámetros de consulta tienen un formato incorrecto. Revisa los siguientes parámetros y confirma que cumplan con el formato requerido antes de volver a intentarlo. |
| AUT-0009 | Solicitud incorrecta | El servidor no pudo interpretar la solicitud debido a una sintaxis incorrecta. Revisa los campos indicados y vuelve a intentarlo. |
| AUT-0010 | Longitud de clave de metadatos excedida | La clave de metadatos supera la longitud máxima permitida. Usa una clave más corta. |
| AUT-0011 | Longitud de valor de metadatos excedida | El valor de metadatos supera la longitud máxima permitida. Usa un valor más corto. |
| AUT-0012 | Anidamiento de metadatos no válido | El objeto de metadatos no puede contener valores anidados. Confirma que el valor no esté anidado y vuelve a intentarlo. |
| AUT-0013 | Tipo de concesión no válido | El ‘grantType’ proporcionado no es válido. Los tipos de concesión aceptados son password, client_credentials, refresh_token u otros. Proporciona un tipo válido. |
| AUT-0014 | Campos faltantes en el tipo de concesión | Al ‘grant_type’ proporcionado le faltan campos obligatorios. Consulta la documentación para obtener orientación. |
| AUT-1001 | Tipo de concesión no admitido | El ‘grantType’ proporcionado no es compatible con esta aplicación. Consulta los tipos de concesión admitidos por la aplicación. |
401
code | title | message |
|---|---|---|
| AUT-0006 | Token faltante | Se debe proporcionar un token válido en el encabezado de la solicitud. Incluye un token y vuelve a intentarlo. |
| AUT-0007 | Token no válido | El token proporcionado está vencido, no es válido o tiene un formato incorrecto. Proporciona un token válido y vuelve a intentarlo. |
| AUT-1002 | Usuario o contraseña no válidos | El ‘username’ o ‘password’ proporcionado es incorrecto. Verifica las credenciales y vuelve a intentarlo. |
| AUT-1003 | Token no válido | El token proporcionado está vencido, no es válido o tiene un formato incorrecto. Proporciona un token válido y vuelve a intentarlo. |
| AUT-1004 | Cliente no válido | El ‘clientId’ o ‘clientSecret’ proporcionado es incorrecto. Verifica las credenciales y vuelve a intentarlo. |
| AUT-1005 | Token de actualización no válido | El ‘refreshToken’ proporcionado no es válido, está vencido o fue revocado. Verifica el token y vuelve a intentarlo. |
403
code | title | message |
|---|---|---|
| AUT-0008 | Error de aplicación de permisos | El enforcer no está configurado correctamente. Contacta a tu administrador si crees que esto es un error. |
| AUT-0021 | IP no permitida | El acceso desde tu red no está permitido para este espacio de trabajo. Contacta a tu administrador. |
404
code | title | message |
|---|---|---|
| AUT-1015 | Sujeto de aplicación no encontrado | No se encontró ningún sujeto para el ‘sub’ proporcionado. Consulta la documentación de aplicación de permisos para conocer el valor correcto de ‘sub’. |
500
code | title | message |
|---|---|---|
| AUT-0005 | Error interno del servidor | El servidor encontró un error inesperado. Vuelve a intentarlo más tarde o contacta a soporte. |
Errores de Identity
Los siguientes errores pueden ocurrir al interactuar con los endpoints de las Identity APIs. Cada error sigue nuestra estructura estándar.
400
code | title | message |
|---|---|---|
| IDE-0001 | Campos faltantes en la solicitud | A tu solicitud le faltan uno o más campos obligatorios. |
| IDE-0002 | Tipo de campo no válido en la solicitud | El tipo de campo proporcionado en la solicitud no es válido. |
| IDE-0003 | Parámetro de ruta no válido | Uno o más parámetros de ruta tienen un formato incorrecto. |
| IDE-0004 | Campos inesperados en la solicitud | El cuerpo de la solicitud contiene más campos de los esperados. Envía solo los campos permitidos. |
| IDE-0005 | Parámetro de consulta no válido | Uno o más parámetros de consulta tienen un formato incorrecto. Revisa los parámetros y confirma que cumplan con el formato requerido antes de volver a intentarlo. |
| IDE-0007 | Solicitud incorrecta | El servidor no pudo interpretar la solicitud debido a una sintaxis incorrecta. |
| IDE-0010 | Error de campo no modificable | Tu solicitud incluye un campo que no se puede modificar. |
| IDE-0011 | Error de campo inmutable | El campo no se puede modificar. Elimínalo de tu solicitud. |
| IDE-0012 | Nombre de aplicación no válido | El nombre de aplicación proporcionado no es válido. |
| IDE-0013 | El ID de usuario no coincide | El ID proporcionado no coincide con el propietario del token. |
| IDE-0014 | Longitud de clave de metadatos excedida | La clave de metadatos supera la longitud máxima permitida de 100 caracteres. Usa una clave más corta. |
| IDE-0015 | Longitud de valor de metadatos excedida | El valor de metadatos supera la longitud máxima permitida de 2000 caracteres. Usa un valor más corto. |
| IDE-0016 | Anidamiento de metadatos no válido | El objeto de metadatos no puede contener valores anidados. Confirma que el valor no esté anidado y vuelve a intentarlo. |
| IDE-0017 | El usuario ya existe | El usuario ya existe. Usa un nombre de usuario o correo electrónico diferente y vuelve a intentarlo. |
| IDE-0020 | Contraseña demasiado corta | La contraseña debe tener al menos 12 caracteres. |
| IDE-0021 | Contraseña sin mayúscula | La contraseña debe contener al menos una letra mayúscula. |
| IDE-0022 | Contraseña sin minúscula | La contraseña debe contener al menos una letra minúscula. |
| IDE-0023 | Contraseña sin dígito | La contraseña debe contener al menos un dígito. |
| IDE-0024 | Contraseña sin carácter especial | La contraseña debe contener al menos un carácter especial. |
| IDE-0025 | Caracteres repetidos consecutivos en la contraseña | La contraseña no debe contener caracteres repetidos consecutivos. |
| IDE-0026 | Regla de contraseña desconocida | Regla de validación de contraseña desconocida. |
| IDE-0027 | Contraseña anterior no válida | La contraseña anterior proporcionada no es válida. |
| IDE-0035 | Lista de IP permitidas demasiado grande | La lista de IP permitidas es demasiado grande: las entradas combinadas y separadas por comas no deben superar los 200 caracteres. Elimina algunas entradas y vuelve a intentarlo. |
| IDE-0036 | Entrada de lista de IP permitidas no válida | La entrada {value} de la lista de IP permitidas no es una dirección IP o un bloque CIDR válido. Corrígela y vuelve a intentarlo. |
| IDE-0037 | Ámbito de lista de IP permitidas no válido | El ámbito de aplicación {value} de la lista de IP permitidas no es compatible. Usa console, api o both, y vuelve a intentarlo. |
401
code | title | message |
|---|---|---|
| IDE-0008 | Token faltante | Se debe proporcionar un token válido en el encabezado de la solicitud. Incluye un token y vuelve a intentarlo. |
| IDE-0009 | Token no válido | El token proporcionado está vencido, no es válido o tiene un formato incorrecto. Proporciona un token válido y vuelve a intentarlo. |
404
code | title | message |
|---|---|---|
| IDE-1001 | ID de aplicación no encontrado | El ID de aplicación proporcionado no existe en nuestros registros. |
| IDE-1002 | No se encontraron aplicaciones | No se encontraron aplicaciones en la búsqueda. |
| IDE-1003 | ID de usuario no encontrado | El ID de usuario proporcionado no existe en nuestros registros. |
| IDE-1004 | No se encontraron usuarios | No se encontraron usuarios en la búsqueda. |
| IDE-1005 | No se encontraron grupos | No se encontraron grupos en la búsqueda. |
| IDE-1006 | ID de grupo no encontrado | El ID de grupo proporcionado no existe en nuestros registros. |
500
code | title | message |
|---|---|---|
| IDE-0006 | Error interno del servidor | El servidor encontró un error inesperado. Vuelve a intentarlo más tarde. |