Tratamento de erros

Todo o tratamento de erros do Web SDK está centralizado nesta seção. O callback error recebe um objeto ErrorBio que expõe getCode() e getDescription().

Erros de prepareCamera

Código	Descrição
`73000`	Erro desconhecido e inesperado durante o uso normal das APIs do SDK
`73001`	`<property>` é obrigatório
`73002`	`<property>` deve ser uma instância de `<class>`
`73003`	`<class>` com o nome `<name>` não está disponível para injeção
`73004`	O tipo da classe deve ser uma função ou uma classe
`73005`	Não foi possível encontrar o locale `<locale>`
`73006`	Não foi possível encontrar o texto: `<text>`
`73100`	Não foi possível conectar à internet
`73200`	Não foi possível encontrar o arquivo JSON do SDK Unico
`73201`	Não foi possível carregar o arquivo JSON do SDK Unico
`73202`	O arquivo JSON do SDK Unico é inválido
`73204`	Não foi possível inicializar o SDK — configure o ambiente via `setEnvironment` no build
`73300`	Não foi possível autenticar esta aplicação
`73301`	Não foi possível autenticar esta aplicação
`73302`	token de autenticação não encontrado
`73303`	O host atual não está registrado
`73400`	Não foi possível inicializar a câmera
`73401`	Não foi possível carregar os modelos de ML para esta câmera
`73402`	A chave não pôde ser verificada devido a problemas de conectividade no dispositivo do usuário
`73403`	Esta combinação de dispositivo/plataforma/navegador/versão não é suportada pelo SDK
`73404`	O dispositivo está em orientação paisagem. O SDK só pode ser usado em modo retrato
`73405`	Dispositivo bloqueado devido a múltiplas tentativas falhas
`73406`	A sessão foi cancelada — o SDK foi aberto em um iFrame
`73407`	O SDK não foi totalmente carregado
`73500`	Não foi possível obter a sessão
`73501`	Não foi possível obter a sessão
`73502`	token de sessão não encontrado
`73600`	Não foi possível encontrar o recurso de câmera
`73601`	Não foi possível iniciar a câmera em modo de produção
`74000`	Hexadecimal inválido
`74001`	O objeto não é um `UnicoTheme`

Erros de openCamera

Código	Descrição
`73700`	Não foi possível analisar a resposta da câmera
`73704`	O usuário pressionou o botão cancelar e não completou a sessão
`73706`	Acesso à câmera negado — o usuário negou explicitamente a permissão ou a política do dispositivo a bloqueia
`73707`	A sessão foi cancelada devido ao encerramento do aplicativo, modo de espera, notificação do SO ou execução em segundo plano
`73708`	A sessão foi cancelada porque o dispositivo está em modo paisagem
`73710`	A sessão foi cancelada porque o usuário não conseguiu concluí-la dentro do tempo limite estabelecido
`73715`	A sessão foi cancelada porque nem todas as imagens de orientação foram configuradas
`73716`	A sessão foi cancelada porque o SDK não conseguiu iniciar a câmera neste dispositivo
`73717`	A sessão foi cancelada porque o usuário estava em estado de bloqueio
`73718`	Erro desconhecido e inesperado durante o uso normal das APIs do SDK
`73720`	O desenvolvedor cancelou programaticamente a sessão via API
`73721`	A sessão foi cancelada devido a uma mudança de orientação do dispositivo durante a sessão
`73722`	A sessão foi cancelada porque o documento não está pronto
`73723`	A sessão foi cancelada porque havia outra sessão em andamento
`73724`	A sessão foi cancelada porque a câmera foi aberta em um iFrame
`73728`	Erro de conexão — use HTTPS para conectar
`73729`	Navegador não suportado — abra em outro navegador
`73730`	Não foi possível inicializar uma sessão de liveness ativo — erro de licença desconhecido
`73731`	Não foi possível inicializar uma sessão de liveness ativo — licença expirada
`73732`	Não foi possível inicializar uma sessão de liveness ativo — origem não permitida
`73800`	Não foi possível criptografar a resposta
`73900`	Não foi possível obter informações do sistema

Catálogo oficial de erros

Os códigos acima refletem o catálogo do Web SDK. O catálogo oficial de códigos de erro multiplataforma está disponível em Referência de API > Códigos de erro.

Tratando o callback

const callback = {
  on: {
    success: (obj) => {
      console.log(obj.base64);
      console.log(obj.encrypted);
    },
    error: (error) => {
      const code = error.getCode();
      const description = error.getDescription();
      // tratar o erro
    }
  }
};

callback obrigatório

O objeto callback é obrigatório. Se não for implementado corretamente (cobrindo os eventos success e error), o SDK lança uma exceção que, se não tratada, é exibida no console do usuário.