Saltar al contenido principal
El Access Manager devuelve respuestas de error consistentes y estructuradas. Esto te ayuda a comprender rápidamente qué salió mal y cómo solucionarlo. Formato de error 
{
   "code": "<codigo_error>",
   "title": "<titulo_error>",
   "message": "<mensaje_error>"
}
Definiciones de campos
  • code – Un identificador estable y único para el error. Útil para el manejo programático y solicitudes de soporte.
  • title – Un resumen breve y legible del problema.
  • message – Orientación detallada para ayudarte a resolver el error.
Esta estructura asegura que siempre obtengas retroalimentación accionable cuando algo no sale como se espera.

​
Errores de autenticación

Los siguientes errores pueden ocurrir al interactuar con los endpoints de APIs de Auth. Cada error sigue nuestra estructura estándar, facilitando la depuración y respuesta a problemas de forma programática.

​
400

CódigoTítuloMensajeTraducción
AUT-0001Missing Fields in RequestYour request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.Su solicitud carece de uno o más campos obligatorios. Consulte la documentación para asegurarse de que todos los campos necesarios estén incluidos en su solicitud.
AUT-0002Invalid Path ParameterOne or more path parameters are in an incorrect format. Please check the following parameters and ensure they meet the required format before trying again.Uno o más parámetros de ruta tienen un formato incorrecto. Verifique los siguientes parámetros y asegúrese de que cumplan con el formato requerido antes de intentar nuevamente.
AUT-0003Unexpected Fields in the RequestThe request body contains more fields than expected. Please send only the allowed fields as per the documentation. The unexpected fields are listed in the fields object.El cuerpo de la solicitud contiene más campos de los esperados. Envíe solo los campos permitidos según la documentación. Los campos inesperados se enumeran en el objeto de campos.
AUT-0004Invalid Query ParameterOne or more query parameters are in an incorrect format. Please check the following parameters and ensure they meet the required format before trying again.Uno o más parámetros de consulta tienen un formato incorrecto. Verifique los siguientes parámetros y asegúrese de que cumplan con el formato requerido antes de intentar nuevamente.
AUT-0009Bad RequestThe server could not understand the request due to malformed syntax. Please check the listed fields and try again.El servidor no pudo entender la solicitud debido a una sintaxis mal formada. Verifique los campos indicados e intente nuevamente.
AUT-0010Metadata Key Length ExceededThe metadata key exceeds the maximum allowed length. Please use a shorter key.La clave de metadatos excede la longitud máxima permitida. Utilice una clave más corta.
AUT-0011Metadata Value Length ExceededThe metadata value exceeds the maximum allowed length. Please use a shorter value.El valor de metadatos excede la longitud máxima permitida. Utilice un valor más corto.
AUT-0012Invalid Metadata NestingThe metadata object cannot contain nested values. Please ensure that the value is not nested and try again.El objeto de metadatos no puede contener valores anidados. Asegúrese de que el valor no esté anidado e intente nuevamente.
AUT-0013Invalid Grant TypeThe provided ‘grantType’ is not valid. Accepted grant types are password, client_credentials, refresh_token, or others. Please provide a valid type.El ‘grantType’ proporcionado no es válido. Los tipos de concesión aceptados son password, client_credentials, refresh_token u otros. Proporcione un tipo válido.
AUT-0014Grant Type Missing FieldsThe provided ‘grant_type’ is missing required fields. Please refer to the documentation for guidance.Al ‘grant_type’ proporcionado le faltan campos obligatorios. Consulte la documentación para obtener orientación.
AUT-1001Unsupported Grant TypeThe provided ‘grantType’ is not supported by this application. Please refer to the application’s supported grant types.El ‘grantType’ proporcionado no es compatible con esta aplicación. Consulte los tipos de concesión admitidos por la aplicación.

​
401

CódigoTítuloMensajeTraducción
AUT-0006Token MissingA valid token must be provided in the request header. Please include a token and try again.Se debe proporcionar un token válido en el encabezado de la solicitud. Incluya un token e intente nuevamente.
AUT-0007Invalid TokenThe provided token is expired, invalid or malformed. Please provide a valid token and try again.El token proporcionado está vencido, es inválido o está mal formado. Proporcione un token válido e intente nuevamente.
AUT-1002Invalid Username or PasswordThe provided ‘username’ or ‘password’ is incorrect. Please verify the credentials and try again.El ‘username’ o ‘password’ proporcionado es incorrecto. Verifique las credenciales e intente nuevamente.
AUT-1003Invalid TokenThe provided token is expired, invalid or malformed. Please provide a valid token and try again.El token proporcionado está vencido, es inválido o está mal formado. Proporcione un token válido e intente nuevamente.
AUT-1004Invalid ClientThe provided ‘clientId’ or ‘clientSecret’ is incorrect. Please verify the credentials and try again.El ‘clientId’ o ‘clientSecret’ proporcionado es incorrecto. Verifique las credenciales e intente nuevamente.
AUT-1005Invalid Refresh TokenThe provided ‘refreshToken’ is invalid, expired or revoked. Please verify the token and try again.El ‘refreshToken’ proporcionado es inválido, está vencido o fue revocado. Verifique el token e intente nuevamente.

​
403

CódigoTítuloMensajeTraducción
AUT-0008Permission Enforcement ErrorThe enforcer is not configured properly. Please contact your administrator if you believe this is an error.El sistema de aplicación de permisos no está configurado correctamente. Contacte a su administrador si cree que esto es un error.

​
404

CódigoTítuloMensajeTraducción
AUT-1015Enforcement Sub Not FoundNo subject was found for the provided ‘sub’. Please refer to the enforcement documentation for guidance on the correct ‘sub’ value.No se encontró un sujeto para el ‘sub’ proporcionado. Consulte la documentación de aplicación de permisos para obtener orientación sobre el valor correcto de ‘sub’.

​
500

CódigoTítuloMensajeTraducción
AUT-0005Internal Server ErrorThe server encountered an unexpected error. Please try again later or contact support.El servidor encontró un error inesperado. Intente nuevamente más tarde o contacte al soporte.

​
Errores de identidad

Los siguientes errores pueden ocurrir al interactuar con los endpoints de APIs de Identity. Cada error sigue nuestra estructura estándar, facilitando la depuración y respuesta a problemas de forma programática.

​
400

CódigoTítuloMensajeTraducción
IDE-0001Missing Fields in RequestYour request is missing one or more required fields.Su solicitud carece de uno o más campos obligatorios.
IDE-0002Invalid Field Type in RequestThe provided field type in the request is invalid.El tipo de campo proporcionado en la solicitud es inválido.
IDE-0003Invalid Path ParameterOne or more path parameters are in an incorrect format.Uno o más parámetros de ruta tienen un formato incorrecto.
IDE-0004Unexpected Fields in the RequestThe request body contains more fields than expected. Please send only the allowed fields.El cuerpo de la solicitud contiene más campos de los esperados. Envíe solo los campos permitidos.
IDE-0005Invalid Query ParameterOne or more query parameters are in an incorrect format. Please check the parameters and ensure they meet the required format before trying again.Uno o más parámetros de consulta tienen un formato incorrecto. Verifique los parámetros y asegúrese de que cumplan con el formato requerido antes de intentar nuevamente.
IDE-0007Bad RequestThe server could not understand the request due to malformed syntax.El servidor no pudo entender la solicitud debido a una sintaxis mal formada.
IDE-0010Unmodifiable Field ErrorYour request includes a field that cannot be modified.Su solicitud incluye un campo que no se puede modificar.
IDE-0011Immutable Field ErrorThe field cannot be modified. Please remove it from your request.El campo no se puede modificar. Elimínelo de su solicitud.
IDE-0012Invalid Application NameThe provided application name is invalid.El nombre de aplicación proporcionado es inválido.
IDE-0013User ID Not MatchThe provided ID does not match the token owner.El ID proporcionado no coincide con el propietario del token.
IDE-0014Metadata Key Length ExceededThe metadata key exceeds the maximum allowed length of 100 characters. Please use a shorter key.La clave de metadatos excede la longitud máxima permitida de 100 caracteres. Utilice una clave más corta.
IDE-0015Metadata Value Length ExceededThe metadata value exceeds the maximum allowed length of 2000 characters. Please use a shorter value.El valor de metadatos excede la longitud máxima permitida de 2000 caracteres. Utilice un valor más corto.
IDE-0016Invalid Metadata NestingThe metadata object cannot contain nested values. Please ensure that the value is not nested and try again.El objeto de metadatos no puede contener valores anidados. Asegúrese de que el valor no esté anidado e intente nuevamente.
IDE-0017User Already ExistsThe user already exists. Please use a different username or email and try again.El usuario ya existe. Utilice un nombre de usuario o correo electrónico diferente e intente nuevamente.
IDE-0020Password Too ShortThe password must be at least 12 characters long.La contraseña debe tener al menos 12 caracteres.
IDE-0021Password No UppercaseThe password must contain at least one uppercase letter.La contraseña debe contener al menos una letra mayúscula.
IDE-0022Password No LowercaseThe password must contain at least one lowercase letter.La contraseña debe contener al menos una letra minúscula.
IDE-0023Password No DigitThe password must contain at least one digit.La contraseña debe contener al menos un dígito.
IDE-0024Password No Special CharThe password must contain at least one special character.La contraseña debe contener al menos un carácter especial.
IDE-0025Password Consecutive RepeatedThe password must not contain consecutive repeated characters.La contraseña no debe contener caracteres repetidos consecutivos.
IDE-0026Password Unknown RuleUnknown password validation rule.Regla de validación de contraseña desconocida.
IDE-0027Old Password InvalidThe old password provided is invalid.La contraseña anterior proporcionada es inválida.

​
401

CódigoTítuloMensajeTraducción
IDE-0008Token MissingA valid token must be provided in the request header. Please include a token and try again.Se debe proporcionar un token válido en el encabezado de la solicitud. Incluya un token e intente nuevamente.
IDE-0009Invalid TokenThe provided token is expired, invalid or malformed. Please provide a valid token and try again.El token proporcionado está vencido, es inválido o está mal formado. Proporcione un token válido e intente nuevamente.

​
404

CódigoTítuloMensajeTraducción
IDE-1001Application ID Not FoundThe provided application ID does not exist in our records.El ID de aplicación proporcionado no existe en nuestros registros.
IDE-1002No Applications FoundNo applications were found in the search.No se encontraron aplicaciones en la búsqueda.
IDE-1003User ID Not FoundThe provided user ID does not exist in our records.El ID de usuario proporcionado no existe en nuestros registros.
IDE-1004No Users FoundNo users were found in the search.No se encontraron usuarios en la búsqueda.
IDE-1005No Groups FoundNo groups were found in the search.No se encontraron grupos en la búsqueda.
IDE-1006Group ID Not FoundThe provided group ID does not exist in our records.El ID de grupo proporcionado no existe en nuestros registros.

​
500

CódigoTítuloMensajeTraducción
IDE-0006Internal Server ErrorThe server encountered an unexpected error. Please try again later.El servidor encontró un error inesperado. Intente nuevamente más tarde.