RodoData VIO API · CNH e CRLV

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

Envie um PDF ou uma imagem. A RodoData localiza o QR Code VIO, decodifica os dados do documento e devolve uma resposta estruturada para o seu sistema, com validação criptográfica quando aplicável.

  • PDF, PNG, JPEG e GIF
  • API REST v1
  • Resposta JSON estruturada
Documento
CNH / CRLV
PDF ou imagem
{ }JSON
{
  "success": true,
  "document_type": "CNH",
  "signature_valid": true,
  "data": {
    "nome": "...",
    "categoria": "B"
  }
}
01
Rápido de integrar

Uma chamada HTTP e uma resposta JSON previsível.

02
Dados estruturados

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

03
Pronto para automação

Use em onboarding, backoffice, mobilidade, seguros e locação.

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.

Quando o documento e os dados necessários permitem, a resposta também informa o resultado da validação criptográfica. A API é indicada para sistemas que precisam incorporar dados documentais a fluxos automatizados.

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

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

ProcessamentoQR Code VIO

O serviço procura, decodifica e interpreta o QR compatível.

SaídaJSON

Campos estruturados, tipo do documento, validação 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. 1

    Envie o arquivo

    Faça upload da CNH ou do CRLV em PDF ou imagem.

  2. 2

    Localizamos o QR

    Em PDFs, a RodoData analisa sequencialmente até as 20 primeiras páginas e interrompe quando encontra o código.

  3. 3

    Decodificamos

    O conteúdo VIO é interpretado e a validação criptográfica é verificada quando aplicável.

  4. 4

    Você recebe JSON

    Seu sistema recebe dados estruturados para continuar o fluxo automaticamente.

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
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,
  "data": {
    "nome": "...",
    "categoria": "B"
  },
  "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.

Entrada flexível

Trabalhe com PDF, PNG, JPEG ou GIF no mesmo endpoint.

Saída previsível

Receba JSON estruturado em vez de depender da apresentação visual do documento.

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?

Quando o QR e os dados necessários permitem a verificação, a resposta informa o resultado da validação criptográfica. O campo deve ser interpretado conforme a documentação da API.

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.

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.