Pular para o conteúdo principal
Formato do erro 
{
   "code": "<error_code>",
   "title": "<error_title>",
   "message": "<error_message>"
}
Definição dos campos
  • code – Um identificador único e estável para o erro. Útil para tratamento programático e solicitações de suporte.
  • title – Um resumo curto e legível do problema.
  • message – Orientação detalhada para ajudá-lo a resolver o erro.
Essa estrutura garante que você sempre receba feedback acionável quando algo não sair como esperado.

​
Erros de autenticação

Os seguintes erros podem ocorrer ao interagir com os endpoints das APIs de Autenticação. Cada erro segue nossa estrutura padrão, facilitando a depuração e a resposta a problemas de forma programática.

​
400

CódigoTítuloMensagemTradução
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.Sua requisição está faltando um ou mais campos obrigatórios. Consulte a documentação para garantir que todos os campos necessários estejam incluídos na sua requisição.
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.Um ou mais parâmetros de caminho estão em formato incorreto. Verifique os seguintes parâmetros e certifique-se de que atendem ao formato exigido antes de tentar novamente.
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.O corpo da requisição contém mais campos do que o esperado. Envie apenas os campos permitidos conforme a documentação. Os campos inesperados estão listados no objeto fields.
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.Um ou mais parâmetros de consulta estão em formato incorreto. Verifique os seguintes parâmetros e certifique-se de que atendem ao formato exigido antes de tentar novamente.
AUT-0009Bad RequestThe server could not understand the request due to malformed syntax. Please check the listed fields and try again.O servidor não conseguiu entender a requisição devido a uma sintaxe malformada. Verifique os campos listados e tente novamente.
AUT-0010Metadata Key Length ExceededThe metadata key exceeds the maximum allowed length. Please use a shorter key.A chave de metadados excede o comprimento máximo permitido. Use uma chave mais curta.
AUT-0011Metadata Value Length ExceededThe metadata value exceeds the maximum allowed length. Please use a shorter value.O valor de metadados excede o comprimento máximo permitido. Use um valor mais curto.
AUT-0012Invalid Metadata NestingThe metadata object cannot contain nested values. Please ensure that the value is not nested and try again.O objeto de metadados não pode conter valores aninhados. Certifique-se de que o valor não está aninhado e tente novamente.
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.O ‘grantType’ fornecido não é válido. Os tipos de concessão aceitos são password, client_credentials, refresh_token, entre outros. Forneça um tipo válido.
AUT-0014Grant Type Missing FieldsThe provided ‘grant_type’ is missing required fields. Please refer to the documentation for guidance.O ‘grant_type’ fornecido está faltando campos obrigatórios. Consulte a documentação para orientação.
AUT-1001Unsupported Grant TypeThe provided ‘grantType’ is not supported by this application. Please refer to the application’s supported grant types.O ‘grantType’ fornecido não é suportado por esta aplicação. Consulte os tipos de concessão suportados pela aplicação.

​
401

CódigoTítuloMensagemTradução
AUT-0006Token MissingA valid token must be provided in the request header. Please include a token and try again.Um token válido deve ser fornecido no cabeçalho da requisição. Inclua um token e tente novamente.
AUT-0007Invalid TokenThe provided token is expired, invalid or malformed. Please provide a valid token and try again.O token fornecido está expirado, inválido ou malformado. Forneça um token válido e tente novamente.
AUT-1002Invalid Username or PasswordThe provided ‘username’ or ‘password’ is incorrect. Please verify the credentials and try again.O ‘username’ ou ‘password’ fornecido está incorreto. Verifique as credenciais e tente novamente.
AUT-1003Invalid TokenThe provided token is expired, invalid or malformed. Please provide a valid token and try again.O token fornecido está expirado, inválido ou malformado. Forneça um token válido e tente novamente.
AUT-1004Invalid ClientThe provided ‘clientId’ or ‘clientSecret’ is incorrect. Please verify the credentials and try again.O ‘clientId’ ou ‘clientSecret’ fornecido está incorreto. Verifique as credenciais e tente novamente.
AUT-1005Invalid Refresh TokenThe provided ‘refreshToken’ is invalid, expired or revoked. Please verify the token and try again.O ‘refreshToken’ fornecido é inválido, está expirado ou foi revogado. Verifique o token e tente novamente.

​
403

CódigoTítuloMensagemTradução
AUT-0008Permission Enforcement ErrorThe enforcer is not configured properly. Please contact your administrator if you believe this is an error.O enforcer não está configurado corretamente. Entre em contato com seu administrador se acreditar que isso é um erro.

​
404

CódigoTítuloMensagemTradução
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.Nenhum sujeito foi encontrado para o ‘sub’ fornecido. Consulte a documentação de enforcement para orientação sobre o valor correto de ‘sub’.

​
500

CódigoTítuloMensagemTradução
AUT-0005Internal Server ErrorThe server encountered an unexpected error. Please try again later or contact support.O servidor encontrou um erro inesperado. Tente novamente mais tarde ou entre em contato com o suporte.

​
Erros de identidade

Os seguintes erros podem ocorrer ao interagir com os endpoints das APIs de Identidade. Cada erro segue nossa estrutura padrão, facilitando a depuração e a resposta a problemas de forma programática.

​
400

CódigoTítuloMensagemTradução
IDE-0001Missing Fields in RequestYour request is missing one or more required fields.Sua requisição está faltando um ou mais campos obrigatórios.
IDE-0002Invalid Field Type in RequestThe provided field type in the request is invalid.O tipo de campo fornecido na requisição é inválido.
IDE-0003Invalid Path ParameterOne or more path parameters are in an incorrect format.Um ou mais parâmetros de caminho estão em formato incorreto.
IDE-0004Unexpected Fields in the RequestThe request body contains more fields than expected. Please send only the allowed fields.O corpo da requisição contém mais campos do que o esperado. Envie apenas os 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.Um ou mais parâmetros de consulta estão em formato incorreto. Verifique os parâmetros e certifique-se de que atendem ao formato exigido antes de tentar novamente.
IDE-0007Bad RequestThe server could not understand the request due to malformed syntax.O servidor não conseguiu entender a requisição devido a uma sintaxe malformada.
IDE-0010Unmodifiable Field ErrorYour request includes a field that cannot be modified.Sua requisição inclui um campo que não pode ser modificado.
IDE-0011Immutable Field ErrorThe field cannot be modified. Please remove it from your request.O campo não pode ser modificado. Remova-o da sua requisição.
IDE-0012Invalid Application NameThe provided application name is invalid.O nome da aplicação fornecido é inválido.
IDE-0013User ID Not MatchThe provided ID does not match the token owner.O ID fornecido não corresponde ao proprietário do token.
IDE-0014Metadata Key Length ExceededThe metadata key exceeds the maximum allowed length of 100 characters. Please use a shorter key.A chave de metadados excede o comprimento máximo permitido de 100 caracteres. Use uma chave mais curta.
IDE-0015Metadata Value Length ExceededThe metadata value exceeds the maximum allowed length of 2000 characters. Please use a shorter value.O valor de metadados excede o comprimento máximo permitido de 2000 caracteres. Use um valor mais curto.
IDE-0016Invalid Metadata NestingThe metadata object cannot contain nested values. Please ensure that the value is not nested and try again.O objeto de metadados não pode conter valores aninhados. Certifique-se de que o valor não está aninhado e tente novamente.
IDE-0017User Already ExistsThe user already exists. Please use a different username or email and try again.O usuário já existe. Use um nome de usuário ou e-mail diferente e tente novamente.
IDE-0020Password Too ShortThe password must be at least 12 characters long.A senha deve ter pelo menos 12 caracteres.
IDE-0021Password No UppercaseThe password must contain at least one uppercase letter.A senha deve conter pelo menos uma letra maiúscula.
IDE-0022Password No LowercaseThe password must contain at least one lowercase letter.A senha deve conter pelo menos uma letra minúscula.
IDE-0023Password No DigitThe password must contain at least one digit.A senha deve conter pelo menos um dígito.
IDE-0024Password No Special CharThe password must contain at least one special character.A senha deve conter pelo menos um caractere especial.
IDE-0025Password Consecutive RepeatedThe password must not contain consecutive repeated characters.A senha não deve conter caracteres repetidos consecutivamente.
IDE-0026Password Unknown RuleUnknown password validation rule.Regra de validação de senha desconhecida.
IDE-0027Old Password InvalidThe old password provided is invalid.A senha antiga fornecida é inválida.

​
401

CódigoTítuloMensagemTradução
IDE-0008Token MissingA valid token must be provided in the request header. Please include a token and try again.Um token válido deve ser fornecido no cabeçalho da requisição. Inclua um token e tente novamente.
IDE-0009Invalid TokenThe provided token is expired, invalid or malformed. Please provide a valid token and try again.O token fornecido está expirado, inválido ou malformado. Forneça um token válido e tente novamente.

​
404

CódigoTítuloMensagemTradução
IDE-1001Application ID Not FoundThe provided application ID does not exist in our records.O ID de aplicação fornecido não existe em nossos registros.
IDE-1002No Applications FoundNo applications were found in the search.Nenhuma aplicação foi encontrada na busca.
IDE-1003User ID Not FoundThe provided user ID does not exist in our records.O ID de usuário fornecido não existe em nossos registros.
IDE-1004No Users FoundNo users were found in the search.Nenhum usuário foi encontrado na busca.
IDE-1005No Groups FoundNo groups were found in the search.Nenhum grupo foi encontrado na busca.
IDE-1006Group ID Not FoundThe provided group ID does not exist in our records.O ID de grupo fornecido não existe em nossos registros.

​
500

CódigoTítuloMensagemTradução
IDE-0006Internal Server ErrorThe server encountered an unexpected error. Please try again later.O servidor encontrou um erro inesperado. Tente novamente mais tarde.