Lista de errores de Access Manager

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ódigo	Título	Mensaje
AUT-0001	Missing Fields in Request	Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.
AUT-0002	Invalid Path Parameter	One or more path parameters are in an incorrect format. Please check the following parameters and ensure they meet the required format before trying again.
AUT-0003	Unexpected Fields in the Request	The 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.
AUT-0004	Invalid Query Parameter	One or more query parameters are in an incorrect format. Please check the following parameters and ensure they meet the required format before trying again.
AUT-0009	Bad Request	The server could not understand the request due to malformed syntax. Please check the listed fields and try again.
AUT-0010	Metadata Key Length Exceeded	The metadata key exceeds the maximum allowed length. Please use a shorter key.
AUT-0011	Metadata Value Length Exceeded	The metadata value exceeds the maximum allowed length. Please use a shorter value.
AUT-0012	Invalid Metadata Nesting	The metadata object cannot contain nested values. Please ensure that the value is not nested and try again.
AUT-0013	Invalid Grant Type	The provided ‘grantType’ is not valid. Accepted grant types are password, client_credentials, refresh_token, or others. Please provide a valid type.
AUT-0014	Grant Type Missing Fields	The provided ‘grant_type’ is missing required fields. Please refer to the documentation for guidance.
AUT-1001	Unsupported Grant Type	The provided ‘grantType’ is not supported by this application. Please refer to the application’s supported grant types.

401

Código	Título	Mensaje
AUT-0006	Token Missing	A valid token must be provided in the request header. Please include a token and try again.
AUT-0007	Invalid Token	The provided token is expired, invalid or malformed. Please provide a valid token and try again.
AUT-1002	Invalid Username or Password	The provided ‘username’ or ‘password’ is incorrect. Please verify the credentials and try again.
AUT-1003	Invalid Token	The provided token is expired, invalid or malformed. Please provide a valid token and try again.
AUT-1004	Invalid Client	The provided ‘clientId’ or ‘clientSecret’ is incorrect. Please verify the credentials and try again.
AUT-1005	Invalid Refresh Token	The provided ‘refreshToken’ is invalid, expired or revoked. Please verify the token and try again.

403

Código	Título	Mensaje
AUT-0008	Permission Enforcement Error	The enforcer is not configured properly. Please contact your administrator if you believe this is an error.

404

Código	Título	Mensaje
AUT-1015	Enforcement Sub Not Found	No subject was found for the provided ‘sub’. Please refer to the enforcement documentation for guidance on the correct ‘sub’ value.

500

Código	Título	Mensaje
AUT-0005	Internal Server Error	The server encountered an unexpected error. Please try again later or contact support.

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ódigo	Título	Mensaje
--------	--------------------------------	--------------------------------------------------------------------------------------------------------------------------------------------------
IDE-0001	Missing Fields in Request	Your request is missing one or more required fields.
IDE-0002	Invalid Field Type in Request	The provided field type in the request is invalid.
IDE-0003	Invalid Path Parameter	One or more path parameters are in an incorrect format.
IDE-0004	Unexpected Fields in the Request	The request body contains more fields than expected. Please send only the allowed fields.
IDE-0005	Invalid Query Parameter	One or more query parameters are in an incorrect format. Please check the parameters and ensure they meet the required format before trying again.
IDE-0007	Bad Request	The server could not understand the request due to malformed syntax.
IDE-0010	Unmodifiable Field Error	Your request includes a field that cannot be modified.
IDE-0011	Immutable Field Error	The field cannot be modified. Please remove it from your request.
IDE-0012	Invalid Application Name	The provided application name is invalid.
IDE-0013	User ID Not Match	The provided ID does not match the token owner.
IDE-0014	Metadata Key Length Exceeded	The metadata key exceeds the maximum allowed length of 100 characters. Please use a shorter key.
IDE-0015	Metadata Value Length Exceeded	The metadata value exceeds the maximum allowed length of 2000 characters. Please use a shorter value.
IDE-0016	Invalid Metadata Nesting	The metadata object cannot contain nested values. Please ensure that the value is not nested and try again.
IDE-0017	User Already Exists	The user already exists. Please use a different username or email and try again.
IDE-0020	Password Too Short	The password must be at least 12 characters long.
IDE-0021	Password No Uppercase	The password must contain at least one uppercase letter.
IDE-0022	Password No Lowercase	The password must contain at least one lowercase letter.
IDE-0023	Password No Digit	The password must contain at least one digit.
IDE-0024	Password No Special Char	The password must contain at least one special character.
IDE-0025	Password Consecutive Repeated	The password must not contain consecutive repeated characters.
IDE-0026	Password Unknown Rule	Unknown password validation rule.
IDE-0027	Old Password Invalid	The old password provided is invalid.

401

Código	Título	Mensaje
IDE-0008	Token Missing	A valid token must be provided in the request header. Please include a token and try again.
IDE-0009	Invalid Token	The provided token is expired, invalid or malformed. Please provide a valid token and try again.

404

Código	Título	Mensaje
IDE-1001	Application ID Not Found	The provided application ID does not exist in our records.
IDE-1002	No Applications Found	No applications were found in the search.
IDE-1003	User ID Not Found	The provided user ID does not exist in our records.
IDE-1004	No Users Found	No users were found in the search.
IDE-1005	No Groups Found	No groups were found in the search.
IDE-1006	Group ID Not Found	The provided group ID does not exist in our records.

500

Código	Título	Mensaje
IDE-0006	Internal Server Error	The server encountered an unexpected error. Please try again later.

Introducción

APIs de Auth

APIs de Identity

​Errores de autenticación

​400

​401

​403

​404

​500

​Errores de identidad