Quais formatos de imagem são aceitos pela VIO API?

PNG, JPEG e GIF podem ser enviados pelo endpoint de decodificação. Para imagens, a API também oferece entrada em base64 conforme a documentação.

O que a API de QR Code de CNH e CRLV retorna?

A resposta inclui status da operação, tipo do documento, campos estruturados do QR Code, informações de validação quando disponíveis e um request_id.

A VIO API valida a assinatura do documento?

Sim. A VIO API valida a assinatura criptográfica do QR e, quando a entrada é PDF, analisa também a assinatura digital do arquivo, sua cobertura, certificado e alterações posteriores.

Como autenticar chamadas na RodoData VIO API?

As chamadas usam uma API Key enviada no header Authorization com o esquema Bearer. A chave é criada na área logada da RodoData.

RodoData VIO API · CNH e CRLV

Transforme o QR Code da CNH e do CRLV em JSON pronto para usar.

Q: A VIO API aceita PDF?

Sim. O PDF pode ser enviado no campo file. A RodoData analisa sequencialmente até as 20 primeiras páginas para localizar o QR Code e interrompe o processamento quando o encontra.

Envie o PDF original ou uma imagem. A RodoData valida o QR Code VIO e, quando a entrada é PDF, analisa metadados, assinatura digital, integridade, certificado do signatário e o fingerprint estrutural das imagens internas.

Testar a VIO API Ver documentação

PDF, PNG, JPEG e GIF
API REST v1
Resposta JSON estruturada
Autenticidade profunda e fingerprint das imagens do PDF

Documento

CNH / CRLV

PDF ou imagem

{ }JSON

{
  "success": true,
  "document_type": "CNH",
  "signature_valid": true,
  "data": {
    "nome": "...",
    "categoria": "B"
  }
}

Rápido de integrar

Uma chamada HTTP e uma resposta JSON previsível.

Dados estruturados

Menos digitação manual e menos tratamento de texto no seu fluxo.

Duas camadas de evidência

Combine assinatura do QR VIO com assinatura e integridade do PDF original.

O que é a VIO API?

API para ler QR Code VIO de CNH e CRLV e transformar o conteúdo em dados estruturados.

A RodoData VIO API recebe arquivos de CNH ou CRLV compatíveis, procura o QR Code do documento e processa seu conteúdo. Em vez de sua aplicação depender de digitação manual ou de um formato visual específico, ela recebe campos estruturados em JSON.

No PDF original, a API acrescenta uma camada independente: metadados, assinatura digital PKCS#7, ByteRange, cobertura da revisão assinada, dados do certificado e indicadores de alteração posterior. Também registra dimensões, codificação, objeto PDF, hashes dos streams e fingerprints das tabelas JPEG. Em CNH Digital, tenta extrair a foto visual do PDF para comparação com a imagem embarcada no QR.

Ver especificação técnica da VIO API →

EntradaPDF ou imagem

Envie o arquivo no campo file via multipart/form-data.

ProcessamentoQR + PDF

O serviço valida o QR e, no PDF, examina assinatura, metadados e integridade.

SaídaJSON + evidências

Campos estruturados, autenticidade, fotos comparativas quando disponíveis e request_id.

Como funciona

Do documento ao seu sistema em quatro etapas.

Sem fluxo paralelo e sem operação manual entre a entrada do arquivo e o retorno da API.

1
Envie o arquivo
Faça upload da CNH ou do CRLV em PDF ou imagem.
2
Localizamos o QR
Em PDFs, a RodoData analisa sequencialmente até as 20 primeiras páginas e interrompe quando encontra o código.
3
Validamos as camadas
O QR VIO é verificado e, no PDF, analisamos assinatura digital, certificado, ByteRange e alterações posteriores.
4
Você recebe JSON
Seu sistema recebe dados estruturados, evidências do PDF e fotos do QR/PDF quando disponíveis.

Criar conta e testar

Para desenvolvedores

Uma API simples para um problema documental complexo.

Use autenticação Bearer e envie o documento para POST /v1/vio/decode. A resposta mantém um formato previsível para facilitar integrações e tratamento de erros.

Endpoint versionado em /v1
Autenticação por API Key no header Authorization
Multipart/form-data para PDF e imagens
JSON com request_id para rastreabilidade da chamada
authenticity e pdf quando a entrada é PDF
media.qr_photo e media.pdf_photo para apresentação comparativa

Abrir documentação Ver preços

REQUESTcURL

curl -X POST https://rododata.com/v1/vio/decode \
  -H "Authorization: Bearer rd_live_xxx" \
  -F "file=@documento.pdf"

RESPONSE200 JSON

{
  "success": true,
  "document_type": "CNH",
  "signature_valid": true,
  "authenticity": {
    "status": "verified"
  },
  "pdf": {
    "digital_signature": {
      "cryptographically_valid": true,
      "signer": "DETRAN PR"
    },
    "integrity": {
      "signed_revision_covers_file": true
    }
  },
  "media": {
    "qr_photo": {"mime": "image/png"},
    "pdf_photo": {"mime": "image/png"}
  },
  "request_id": "req_..."
}

Casos de uso

Coloque dados de CNH e CRLV dentro do fluxo que já existe.

ONBOARDING

Cadastros com menos digitação

Extraia dados do documento para preencher ou validar etapas do cadastro em seu sistema.

MOBILIDADE

Operações com motoristas e veículos

Estruture informações documentais para plataformas de mobilidade, logística e gestão de frotas.

SEGUROS E LOCAÇÃO

Fluxos documentais automatizados

Reduza etapas manuais na recepção e estruturação de CNH e CRLV.

BACKOFFICE

Dados padronizados para sistemas internos

Transforme documentos recebidos por diferentes canais em uma resposta consistente para automações.

Por que usar a RodoData

A camada de integração entre o documento e a sua aplicação.

PDF com análise profunda

Metadados, assinatura digital, certificado, ByteRange e integridade entram na resposta.

Fotos comparativas

Na CNH Digital, compare a foto visual extraída do PDF com a imagem de baixa resolução embarcada no QR.

Integração REST

Use uma API HTTP versionada com autenticação Bearer e documentação técnica.

Cobrança por créditos

Consulte o custo de uso e escolha entre créditos avulsos ou planos mensais.

Perguntas frequentes

Dúvidas sobre a API de QR Code de CNH e CRLV.

A VIO API aceita PDF?

Sim. O arquivo pode ser enviado em PDF no campo file. A RodoData analisa sequencialmente até as 20 primeiras páginas para localizar o QR Code e interrompe o processamento quando o encontra.

Quais formatos de imagem são aceitos?

PNG, JPEG e GIF podem ser enviados pelo mesmo endpoint. Para imagens, a API também oferece entrada em base64 conforme a documentação.

O que a API retorna?

A resposta inclui o status da operação, o tipo de documento identificado, campos estruturados do QR, informações de validação quando disponíveis e um request_id.

A API valida a assinatura do documento?

Sim em duas camadas quando a entrada é PDF: a assinatura criptográfica do QR VIO e a assinatura digital do próprio PDF. A resposta também informa cobertura da revisão assinada, certificado e possíveis bytes posteriores à assinatura.

Preciso usar OCR para ler CNH ou CRLV?

Para o fluxo VIO, a RodoData trabalha com o conteúdo do QR Code compatível. A proposta da API é transformar esse conteúdo em dados estruturados sem depender da leitura visual por OCR.

Como autentico as chamadas?

As chamadas comerciais usam uma API Key no header Authorization: Bearer rd_live_xxx. A chave é criada na área logada da RodoData.

Como funciona o preço da VIO API?

O uso consome créditos por consulta concluída. A RodoData oferece recargas avulsas e planos mensais com créditos incluídos. Consulte a página de preços para os valores atuais.

Comece agora

Pare de transformar documento em dado na mão.

Crie sua conta, gere uma chave de API e envie sua primeira CNH ou CRLV.

Testar a VIO API Ver documentação Ler guia prático

Serviço independente. A RodoData não representa SENATRAN, SERPRO, DETRANs ou outros órgãos públicos. A disponibilidade e os campos retornados dependem do documento, do QR Code e das condições de processamento.