consulta.dev.brVIO API & Webhooks
Entrar
API VIO · Consulta Autofill

API VIO para transformar QR Codes em dados prontos.

Leia CNH-e, CRLV-e e documentos compatíveis, revise os dados encontrados e preencha qualquer formulário — sem digitação e sem expor a chave da API.

Revisão antes de preencher Chave protegida no servidor
cadastro.exemplo.com.br/novo-cliente

Novo condutor

Preencha os dados pessoais para continuar.

Tem sua CNH-e em mãos?Preencha o cadastro automaticamente.

Powered by consulta.dev.br
3 formatos

Uma experiência para cada contexto.

O parceiro escolhe o gatilho que combina com seu produto. A câmera, a revisão e o preenchimento continuam sendo do Consulta Autofill.

Opção 01

Ícone dentro do campo

Discreto e contextual. Ideal quando o Autofill auxilia um campo principal, como nome, CPF ou placa.

Opção 02 · Recomendada

Ação no topo do formulário

Explica o benefício antes do clique e deixa claro que vários campos serão preenchidos de uma só vez.

Powered by consulta.dev.br
Opção 03

Câmera, imagem ou PDF

Mais flexível para backoffices e cadastros assistidos, inclusive em computadores sem câmera.

Quer testar com seu próprio formulário?

Criar conta gratuita

Dados do condutor preenchidos5 campos atualizados pelo Consulta Autofill.

O que é o consulta.dev.br?

É uma plataforma independente para transformar o conteúdo de QR Codes VIO em dados revisáveis e JSON estruturado. Não é o aplicativo oficial VIO e não substitui a decisão de uma autoridade sobre a validade de um documento.

Conteúdo técnico revisado em .

Entrada
Conteúdo Base64 capturado de um QR Code VIO.
Saída
Campos identificados em JSON e foto PNG Base64 quando disponível.
Integração
API autenticada, componente Autofill e webhooks com HMAC-SHA256.
Uso responsável
Revisão humana, finalidade autorizada e retenção compatível com a LGPD.
Motor de Alta Performance & Webhooks em Tempo Real

Decodifique QR Codes VIO Instantaneamente

API para leitura de CNH Digital, CRLV e outros documentos VIO brasileiros. Receba os campos estruturados e, quando disponível, a foto diretamente no seu sistema via webhooks assinados.

~10 µs
Benchmark interno do decoder
13
Documentos no catálogo público
BPG Nativo
Extração Direta de Foto
HMAC-SHA256
Webhooks Seguros

O benchmark mede apenas a etapa interna de decodificação. A latência total varia com rede, payload, extração de imagem e integração.

POST /api/v1/decode/payload
# 1. Defina CONSULTA_API_KEY no ambiente e envie o payload Base64
curl -X POST https://consulta.dev.br/api/v1/decode/payload \
  -H "X-API-Key: ${CONSULTA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"payload_base64": "ZBEiAQVAAEc...", "include_photo_base64": true}'
Webhook Event (Instantâneo)
// 2. Exemplo de evento entregue no seu Webhook em tempo real
{
  "id": "evt_k7m2p9x4qr",
  "event": "document.decoded",
  "created_at": "2026-09-02T10:00:00.000Z",
  "data": {
    "template_id": 83,
    "template_name": "CNH - Carteira Nacional de Habilitação",
    "template_owner": "SENATRAN",
    "fields": {
      "nome": "JOAO DA SILVA SANTOS",
      "cpf": "123.456.789-00",
      "data_nascimento": "15/03/1990",
      "rg": "12.345.678-9",
      "orgao_emissor": "SSP/SP",
      "registro": "04567890123",
      "validade": "20/11/2030",
      "primeira_habilitacao": "10/06/2010",
      "categoria": "AB",
      "observacoes": "EAR",
      "local": "SAO PAULO - SP",
      "data_emissao": "20/11/2025",
      "numero_espelho": "B000123456",
      "renach": "SP123456789",
      "codigo_seguranca": "12345678901",
      "nome_pai": "ANTONIO DA SILVA SANTOS",
      "nome_mae": "MARIA APARECIDA SANTOS",
      "nacionalidade": "BRASILEIRA"
    },
    "has_photo": true,
    "photo_base64": "iVBORw0KGgoAAAANSUhEUgAAANgA... (PNG Base64)",
    "photo_info": {
      "width": 216,
      "height": 264,
      "pixel_format": "YCbCr 4:2:0",
      "color_space": "sRGB IEC61966-2.1",
      "bit_depth": 8,
      "file_size": 7352
    }
  }
}
Diferencial Exclusivo

Integração sem Polling com Webhooks em Tempo Real

Esqueça requisições manuais em loop. Cadastre o endpoint do seu backend (Node, PHP, Python, Java, C#) e receba notificações imediatas assim que uma CNH ou documento for escaneado.

Assinatura HMAC-SHA256

Cada requisição contém o header X-Webhook-Signature para você validar a autenticidade.

Logs de entrega minimizados

Acompanhe status, duração, destino e hash de verificação sem persistir o corpo da resposta.

Foto do Condutor Embutida

O payload traz a foto em Base64 já convertida de BPG para PNG de alta fidelidade.

Fluxo de DisparoAutomático
1
Leitura do QR CodeVia câmera, app mobile ou chamada API
2
Decoder interno com benchmark de ~10µsDescompactação e conversão em memória; a chamada de API inclui outros tempos.
3
Webhook disparado para seu servidorPOST https://seusistema.com/webhook com HMAC

Projetado para Escala e Velocidade

Um motor desenvolvido com arquitetura compilada de ultra baixa latência.

Microssegundos de Latência

O benchmark interno de decodificação é de aproximadamente 10 microssegundos. Meça a latência ponta a ponta no ambiente da sua integração.

Decoder BPG Nativo

As fotos de CNH são codificadas em BPG/HEVC. Decodificamos a imagem diretamente em memória sem necessidade de processos pesados.

Templates VIO no motor

A cobertura inclui CNH, CRLV, documentos da Marinha, Exército, educação e conselhos profissionais.

Documentos Brasileiros Suportados

Conheça os documentos que possuem descrição técnica confirmada no catálogo público.

Abrir documentação e catálogo
CNH

CNH - Carteira Nacional de Habilitação

Documento oficial de habilitação de condutores com foto em alta compressão BPG e assinatura ECDSA.

Ver detalhes
CRLV

CRLV - Certificado de Registro e Licenciamento de Veículo

Documento digital anual de licenciamento de veículos em território nacional.

Ver detalhes
ATPV-e

ATPV-e - Autorização para Transferência de Veículo

Autorização digital para compra e venda de veículos e transferência de propriedade.

Ver detalhes
Diploma Digital

Diploma Digital de Graduação

Diploma digital de ensino superior com validação de conformidade e integridade acadêmica.

Ver detalhes
Identidade Militar do Exército

Carteira de Identidade Militar - Exército

Identificação militar de oficiais, praças e servidores das Forças Armadas.

Ver detalhes
Carteira Funcional da Marinha

Carteira Funcional - Marinha do Brasil

Identificação oficial de pessoal militar e aquaviários civis.

Ver detalhes

Planos Simples e Transparentes

Comece gratuitamente com sua chave de API e faça upgrade conforme seu volume aumentar.

Gratuito

Free
R$ 0 / mês

Ideal para testes e pequenos projetos de validação.

  • 5 consultas gratuitas por hora
  • Chave de API dedicada
  • Scanner Web via Câmera
  • 13 documentos no catálogo público
  • ✕ Sem suporte a Webhooks
Começar Grátis

Starter

Starter
R$ 49 / mês

Para projetos e integrações iniciais com webhooks.

  • Até 3 webhooks com HMAC
  • 2.000 consultas incluídas
  • Logs de entrega por 30 dias
  • Extração de fotos PNG em Base64
  • Suporte via E-mail
Assinar Starter
Mais Popular

Profissional

Pro
R$ 99 / mês

Para aplicações, sistemas de onboarding e ERPs em escala.

  • 20.000 consultas incluídas
  • Logs de entrega por até 1 ano
  • Até 20 webhooks com HMAC
  • Extração de fotos PNG em Base64
  • Suporte Prioritário
Assinar Plano Pro

Enterprise

Custom
Sob Consulta

Para locadoras, seguradoras e fintechs com alto volume.

  • 100.000 consultas incluídas
  • Até 100 webhooks com HMAC
  • Retenção de logs por até 1 ano
  • Condições definidas em proposta
Falar com o comercial
Tire Suas Dúvidas

Perguntas Frequentes (FAQ)

Tudo o que você precisa saber sobre a API de decodificação VIO, integração por Webhooks e segurança.

Como funciona a API de leitura de QR Code VIO?
A API recebe em Base64 o conteúdo codificado do QR Code VIO. O motor identifica o template, estrutura os campos disponíveis e, quando o documento contém uma imagem compatível e a opção é solicitada, retorna a foto em PNG Base64 junto do JSON.
Quais documentos oficiais brasileiros são suportados?
O motor possui templates para diferentes documentos VIO. O catálogo público descreve exemplos confirmados no repositório, como CNH, CRLV, ATPV-e, Boletim de Acidente de Trânsito, CAUC, documentos da Marinha, diplomas e carteiras profissionais.
Como funciona a extração da foto do condutor na CNH?
Quando o template contém foto BPG compatível, o motor converte a imagem em memória para PNG e pode retorná-la em Base64. A disponibilidade, as dimensões e a qualidade dependem do conteúdo presente no documento lido.
Qual é o tempo de resposta e latência da API?
O benchmark interno divulgado para a etapa de decodificação é de aproximadamente 10 microssegundos. A latência total da API depende de rede, tamanho do payload, extração de imagem, carga do serviço e webhooks configurados; por isso deve ser medida no ambiente da integração.
O que são os Webhooks em tempo real e como garantir a segurança?
Os Webhooks permitem que seu servidor receba os dados decodificados sem polling. Cada entrega contém assinatura HMAC-SHA256, timestamp e identificador único. O consumidor deve validar o corpo bruto, rejeitar timestamps antigos e deduplicar o identificador da entrega.
Como integrar a API no meu sistema?
A integração usa uma requisição POST com a API key no header X-API-Key e um corpo JSON contendo o payload Base64. A documentação pública traz o contrato básico, exemplos em cURL e orientações para validar webhooks.
A plataforma está em conformidade com a LGPD?
A plataforma aplica minimização e controles técnicos descritos na Política de Privacidade. Gratuito e Starter não retêm o payload bruto; Profissional e Enterprise podem manter o payload de entrada criptografado. A conformidade de cada uso também depende da base legal e das obrigações do cliente controlador.
Como funciona a cobrança e o cancelamento dos planos?
O plano Gratuito possui limite compartilhado por conta e IP. Os limites e valores dos planos pagos são apresentados na página inicial; condições de contratação, alteração e cancelamento devem ser confirmadas nos Termos de Uso e no atendimento comercial.

Ainda tem alguma dúvida técnica ou comercial?

Nossa equipe técnica e comercial está pronta para atender seu projeto ou esclarecer dúvidas de integração.

Falar com Nossa Equipe