Árvore de páginas

Índice


HTTP Status


Referência: https://httpstatuses.com/

Códigos de Sucesso

CódigoDescriçãoResultadoQuando ocorre
200OK

Operação executada com sucesso.

Quando a operação foi realizada com sucesso, e há um retorno no corpo da resposta.

201CREATED

Operação de criação de recursos realizada com sucesso.

Utilizado para indicar que uma criação de recursos foi feita com sucesso.

Em seu retorno, deve incluir os dados que foram criados, bem como um link de acesso ao recurso recém criado.

202ACCEPTED

Utilizado para indicar que uma requisição foi aceita pelo servidor e será processada eventualmente.

Em operações em lote, ou operações cujo processamento será feito de forma assíncrona.

Essa resposta deve conter em seu retorno um link para que seja possível consultar o andamento/resultado da execução.

204NO CONTENT

Operação executada com sucesso.

Quando a operação foi realizada com sucesso, mas não existem dados de retorno.


Códigos de Erros do Cliente

CódigoDescriçãoResultadoQuando ocorre
400BAD REQUEST

Indica um erro de sintaxe na requisição.

Quando a requisição não foi montada corretamente.

Pode ocorrer devido à parâmetros informados incorretamente.

401UNAUTHORIZED

A requisição não foi executada por falta de autorização.

Pode ser causada por :

  • Falta de credenciais de autenticação
  • Credenciais inválidas
  • Credenciais válidas, porém sem acesso ao recurso solicitado


Códigos de Erros do Servidor

CódigoDescriçãoResultadoQuando ocorre
500INTERNAL SERVER ERROR

Erro interno do servidor.

Algum componente do sistema está falhando, favor verificar os logs da aplicação.


OAuth2Exception


Exceções lançadas pela API de autenticação OAuth2.


IDM_OAUTH_0001

Companhia não encontrada para o subdomínio informado.

Informe o subdomínio da companhia onde deseja obter o token de acesso. O subdomínio é a parte inicial do domínio de sua empresa. (subdominio.dominio.com.br)

Exemplo: Para o domínio totvs.fluigidentity.com, o subdominio é totvs.

IDM_OAUTH_0002

Acesso não autorizado.

Verifique se os dados de acesso (nome e senha) estão corretos, bem como o domínio da empresa para o qual deseja acesso.



SecurityException


Exceções lançadas em virtude de validações de segurança do Identity.


IDM_SECURITY_0001

Acesso não permitido a partir do IP de origem do request.

Este erro ocorre quando a empresa estiver configurada para validar o IP de origem das requisições e o IP de ode foi realizado o request não estiver na relação de IPs aceitos pela respectiva empresa.



Company Exceptions


TypeCodeDescription
NOT_FOUNDIDM_COMPANY_00001Company not found
CAN_NOT_UPDATE_DEFAULT_COMPANYIDM_COMPANY_00002Can not update the default company
CAN_NOT_BE_VALIDATEDIDM_COMPANY_00003Object cannot be validated. Check object fields.
DUPLICATE_COMPANY_NAMEIDM_COMPANY_00004Duplicate company name
DUPLICATE_SUBDOMAIN_NAMEIDM_COMPANY_00005Duplicate subdomain name


Desktop SSO Exceptions


TypeCodeDescription
NOT_FOUNDIDM_DESKTOPSSO_00001Desktop SSO not found


Role Exceptions


TypeCodeDescription
INVALIDIDM_ROLE_00001Invalid role


User Account Exceptions


TypeCodeDescription
USER_ACCOUNT_NOT_FOUNDIDM_USERACCOUNT_00001User account not found


User Company Account Exceptions


TypeCodeDescription
USER_COMPANY_ACCOUNT_NOT_FOUNDIDM_USERCOMPANYACCOUNT_00001User company account not found