Status na API

Este artigo contém a descrição completa dos status de pastas e análises na API.

Nome do campo / status	analyses.state	analyses.resolution_status	folder.resolution_status	system_resolution
INITIAL	-	-	estado inicial	estado inicial
FAILED	erro do sistema	erro do sistema	erro do sistema	erro do sistema
FINALIZADA	concluído com êxito	-	concluído com êxito	-
DECLINED	-	verificação falhou	-	verificação falhou
OPERATOR_REQUIRED	-	é necessária uma verificação adicional	-	é necessária uma verificação adicional
SUCCESS	-	verificação bem-sucedida	-	verificação bem-sucedida

Os detalhes de cada status estão abaixo.

Estado da análise (analyses.state)

Este é o estado em que a análise está sendo processada. Os valores deste estado podem ser:

FAILED – a análise falhou devido a algum erro e não pôde ser concluída;

FINALIZADA – o trabalho foi concluído, a análise terminou e é possível verificar o resultado.

Resultado da análise (analyses.resolution_status)

Quando a análise for concluída, será exibido um dos seguintes resultados:

SUCCESS – tudo correu bem, a verificação foi bem-sucedida (por exemplo, os rostos correspondem ou o Liveness foi confirmado);

OPERATOR_REQUIRED (exceto a análise de Liveness) – o resultado deve ser verificado adicionalmente por um operador humano;

O OPERATOR_REQUIRED o status aparece somente se estiver configurado nas configurações de biometria.

DECLINED – a verificação falhou (por exemplo, os rostos não correspondem ou foi detectado algum ataque de spoofing).

Se a análise ainda não tiver sido concluída, o resultado herda um valor de analyses.state.

Status da pasta (folder.resolution_status)

Uma pasta é uma entidade que contém mídias para análise. Se as análises não tiverem sido concluídas, o estágio de processamento das mídias é exibido em resolution_status:

INITIAL – nenhuma análise aplicada;

FAILED – qualquer uma das análises falhou devido a algum erro e não pôde ser concluída;

FINALIZADA – as mídias nesta pasta foram processadas, as análises foram concluídas.

Resultado da pasta (system_resolution)

O resultado da pasta é o resultado consolidado de todas as análises aplicadas às mídias desta pasta. Observação: o resultado da pasta é o resultado do último grupo de análises concluído. Se todas as análises forem concluídas, o resultado será:

SUCCESS – tudo correu bem, todas as análises foram concluídas com sucesso;

OPERATOR_REQUIRED (exceto a análise de Liveness) – não há análises com o DECLINED status, mas uma ou mais análises foram concluídas com o OPERATOR_REQUIRED status;

DECLINED – uma ou mais análises foram concluídas com o DECLINED status.

As análises enviadas em uma única POST solicitação formam um grupo. O resultado do grupo é o resultado "pior" das análises contidas nesse grupo: INITIAL > FAILED > DECLINED > OPERATOR_REQUIRED > SUCCESS, onde SUCCESS significa que todas as análises do grupo foram concluídas com êxito, sem erros.