Códigos de retorno HTTP
As requisições ao Datavalid podem retornar os seguintes código HTTP:
Bilhetagem
O seguinte código será bilhetado no faturamento: 200 (OK)
Os seguintes códigos não serão bilhetados no faturamento: 204 (Sem Conteúdo), 400 (Requisição inválida), 401 (Não autenticado), 403 (Não autorizado), 413 (Request Entity Too Large), 422 (Validação não processada), 500 (Erro no servidor), 502 (Bad Gateway), 503 (Serviço Indisponível) e 504 (Gateway Timeout)
Code / Responses
200 OK
Tudo funcionou como esperado e a validação dos dados foi realizada com sucesso.
204 Sem Conteúdo
O servidor atendeu à solicitação com êxito e não há conteúdo adicional a ser enviado na resposta.
400 Requisição inválida
A requisição não foi aceita pois existe alguma inconsistência em algum campo da requisição. Confira se as propriedades do corpo da requisição estão de acordo com a propriedades esperadas pelo método e se corpo da requisição está codificado em UTF-8.
401 Não autenticado
Problemas durante a autenticação.
403 Não autorizado
Problemas durante a autorização.
413 Request Entity Too Large
A requisição tem um tamanho muito grande. O limite total para o tamanho da requisição é de 3MB. Verifique se o limite de tamanho máximo da requisição está sendo atendido.
422 Validação não processada
A validação não pode ser processada por que algum valor inválido foi enviado na requisição. Os valores inválidos são listadas na resposta.
| Code | message |
|---|---|
| DV001 | LGPD: Dados de menor de idade |
| DV002 | Dados encontrados na base não atendem aos requisitos mínimos para validação Desde 20/03/2023, o Datavalid retorna o código de retorno HTTP 422 - DV002 para os casos em que os dados encontrados na base do Senatran não atendem aos requisitos mínimos para validação. Visando maior efetividade e segurança ao processo de validação de identidade digital, o Quality Checker do Datavalid passa a verificar a qualidade das imagens antes de realizar a validação facial. Importante ressaltar que esse tipo de retorno não será faturado por se tratar de uma requisição não processada (retorno: erro HTTP 422-DV002). |
| DV010 | CPF inválido |
| DV011 | Nacionalidade inválida |
| DV012 | Tipo do documento inválido |
| DV013 | Sexo inválido |
| DV014 | Situação do CPF inválido |
| DV016 | Código da situação da CNH inválido |
| DV017 | Descrição da situação da CNH inválida |
| DV018 | UF inválida |
| DV020 | CNPJ inválido |
| DV021 | Código da situação cadastral inválido |
| DV022 | Porte inválido |
| DV030 | Posição da digital inválida |
| DV031 | Formato da digital inválido |
| DV032 | Erro ao recuperar imagem da digital codificada em base64 |
| DV033 | Imagem da digital corrompida ou fora do formato esperado |
| DV034 | Qualidade baixa da imagem da digital |
| DV035 | Tamanho da imagem da digital inválido |
| DV036 | Posição da digital duplicada |
| DV040 | Imagem da face não encontrada nas bases |
| DV041 | Não foi possível reconhecer a face na imagem |
| DV042 | Tamanho da imagem da face inválido |
| DV043 | Imagem da face corrompida ou fora do formato esperado |
| DV044 | Erro ao recuperar imagem da face codificada em base64 |
| DV045 | Qualidade baixa da imagem da face |
| DV046 | Foi reconhecido mais de uma face na imagem |
| DV047 | Formato da imagem da face inválido |
| DV079 | Documento obrigatório |
| DV080 | Formato do documento inválido |
| DV081 | Erro ao recuperar documento codificado em base64 |
| DV082 | Arquivo do documento corrompida ou fora do formato esperado |
| DV083 | Tamanho do documento inválido |
| DV084 | O documento informado não foi reconhecido como válido |
| DV085 | Foi reconhecido mais de um documento |
| DV086 | Não foi possível recuperar o CPF no documento |
| DV087 | Não foi possível recuperar a foto da face no documento |
| DV088 | O CPF informado não pertence ao CPF do documento |
| DV089 | Quantidade de campos válidos recuperados do documento não é suficiente para validação |
500 Erro no servidor
Ocorreu algum erro interno no Servidor.
502 Bad Gateway
Este erro é apresentado quando há algum erro na geração do token
503 Serviço Indisponível
Erro interno do servidor. Algum serviço integrado ao Datavalid está indisponível no momento.
| code | message |
|---|---|
| DVxx | Algum serviço integrado ao Datavalid está indisponível no momento. |
504: Gateway Timeout
Ocorreu algum erro de rede e o gateway não respondeu a tempo.