Dúvidas - FAQ - Datavalid {API Docs}
Dúvidas - FAQ Dúvidas - FAQ Índice
Desejo mais informações sobre o Datavalid, onde encontrar?
Desejo contratar o Datavalid, como faço?
Contratei o Datavalid, onde obtenho informações para usar o serviço?
O que é contabilizado para faturamento de consumo da API Datavalid?
Como é realizada a contabilização do consumo da API Datavalid?
Como solicitar um relatório de consumo de um período específico (fatura total ou fatura parcial)?
Como será a cobrança no caso de biometria facial da CNH indisponível?
Validação de Informações Biográficas
Quais são os dados possíveis de validação?
Qual o tamanho da imagem que deve ser enviada para validação?
Qual volume população brasileira com CNH?
Quais são as faixas de similaridade biométrica definidas pelo Datavalid?
É possível ter acesso às imagens usadas para comparação na validação biométrica?
Por que não foi realizada a validação da biometria facial se o cidadão possui CNH?
Níveis de Serviço - SLA
SLAs de tempo resposta da API (média de tempo para responder às chamadas)
Qual o nível de serviço (SLA) de disponibilidade do Datavalid?
Quantas requisições por segundo são suportadas?
Tratamento de Erros - Error handling
Existe algum tamanho máximo suportado para o envio das requisições?
Quais são os possíveis erros de retorno na validação biometrica de foto?
Acesse a página do Datavalid para ter mais informações sobre o serviço.
Acesse nosso passo a passo explicando como contratar.
Suas informações referentes ao contrato, como status da habilitação do contrato, Consumer key, Consumer secret, endpoint a ser consumido, link para documentação, estão em na sua área do cliente em https://cliente.serpro.gov.br
Entram na contabilização do Datavalid as requisições com retorno HTTP 200.
O período de prestação de serviços, contabilizado para efeitos de cobrança, será do dia 21 (vinte e um) do mês anterior ao dia 20 (vinte) do mês especificado no relatório. Exemplo: Para o faturamento de Março 21 a apuração é feita de 21/02/21 a 20/03/21.
A apuração pode ser realizada na área do cliente (https://cliente.serpro.gov.br). O usuário logado na área do cliente poderá verificar o consumo dos serviços contratados por meio da funcionalidade "Consumo dos Serviços", sendo possível acompanhar o detalhamento registrado de cada serviço contratado.
A partir de 01 de Junho 2021, para as validações feitas somente com o CPF e a foto, não será cobrada a consulta caso a foto não esteja disponível nas bases (retorno HTTP 422: DV040 - Imagem da face não encontrada nas bases).
Vale ressaltar que, caso seja feita uma validação contendo quaisquer dados biográficos além do CPF, será cobrada a validação biográfica básica, uma vez que foi efetuada validação de dados (retorno HTTP 200: OK).
Esta facilidade está disponível apenas a partir da versão 2 (V2) do Datavalid. Para as versões anteriores, é feita a cobrança de uma validação biográfica. Recomendamos a migração para v2 para utilização desta melhoria.
Os dados que podem ser validados estão listados na Referência da API. Verifique o guia rápido sobre como encontrar todas informações sobre os campos validados.
O tamanho mínimo exigido para o Datavalid funcionar é de 250 x 250 pixels e a resolução da imagem desejada é de 750 x 750 pixels. Veja mais em requisitos para o envio de imagens.
Em torno de 74 milhões de CNHs.
O retorno das validações biométricas são definidas por faixa e percentual. De acordo com o percentual de semelhança, a faixa de probabilidade é identificada. As faixas se aplicam tanto para validação facial quanto para digital.
Altíssima probabilidade 100% - 93%
Alta probabilidade 92,99% - 85%
Baixa probabilidade 84,99% - 32%
Baixíssima probabilidade 31,99% - 0%
O Datavalid nunca retorna imagens ou quaisquer dados utilizados para validação, apenas um percentual de validação de acordo com as imagens enviadas.
Em alguns casos a foto da CNH não está disponível na base. Essa situação pode ocorrer com alguns casos devido o processo de carga das imagens das fotos das CNHs que é realizado pelas gráficas responsáveis pela emissão do documento.
Tempos de referência para validações do Datavalid:
A média de tempo para validações sem imagens é de 1 s;
A média para validações faciais é de 4 s;
As validações de digitais levam entre 2 e 7 segundos, dependendo da quantidade de digitais enviada;
Os tempos variam levemente, de acordo com o horário e as condições de conectividade da rede do cliente, porém pode-se considerar como tempo máximo para resposta o tempo de 30s.
O percentual de SLA médio está acima de 98% nas últimas medições;
Nosso throughput para métodos com imagens é em torno de 3/s, e para métodos sem imagens 5/s.
O tamanho máximo total da requisição não deve exceder o máximo de 3MB.
Os possíveis erros podem ser obtidos na documentação em Referência da API, na sessão Responses, ao final de cada método, ou diretamente na página tabela de código de Erros.