API
API de consulta de multas do DETRAN-RJ
Se o escritório já roda um sistema próprio, dá para usar apenas o motor de consulta. Você cadastra o condutor por API e recebe o extrato completo em JSON, com multas, pontuação, suspensão e cassação, sem trocar de plataforma.
Como funciona
A consulta ao DETRAN-RJ não é instantânea: o portal exige resolução de desafio anti-robô, limita o ritmo e cai com frequência. Por isso o fluxo tem duas etapas.
POST /v1/clientes
{
"nome": "Maria Souza",
"cpf": "123.456.789-00",
"cnh_numero": "01234567890",
"cnh_uf": "RJ",
"data_nascimento": "1985-03-12",
"data_primeira_cnh": "2004-07-30"
}
→ 201 { "cliente_id": "...", "raspagem": { "status": "em_fila" } }
GET /v1/clientes/{cliente_id}
→ 200 {
"raspagem": { "status": "concluida", "consultado_em": "..." },
"dados": {
"multas": [ ... ],
"pontuacao": { ... },
"recurso_suspensao": { "processos": [ ... ] },
"recurso_cassacao": { "processos": [ ... ] }
}
}O POST é idempotente por CPF: reenviar o mesmo documento devolve o mesmo identificador, o que permite recuperar o registro a qualquer momento sem endpoint de busca.
O que vem no JSON
| Bloco | Campos |
|---|---|
| multas[] | numero_ait, data_infracao, local_infracao, enquadramento, artigo_ctb, classificacao, pontos, valor, valor_com_desconto, vencimento, orgao_autuador, placa, status |
| pontuacao | pontos_total, detalhes de 12 meses e 5 anos, processos de suspensão e cassação com a situação de cada um |
| recurso_suspensao | numero, data_processo, situacao_atual, prazo, total de multas e pontos |
| recurso_cassacao | mesma estrutura, em consulta dedicada |
A documentação completa, com autenticação, exemplos de curl, tabela de erros e o contrato campo a campo, está publicada em https://api.infrajus.com.br/v1/docs.
Limites e cobrança
- Rajada: 60 requisições por minuto por chave.
- Cota diária: definida em contrato, por chave.
- Reaproveitamento: o mesmo CPF reenviado em menos de 12 horas não gera consulta nova nem consome cota.
- O que conta: consultas disparadas, não requisições. Ler resultado é livre.
Perguntas frequentes
Existe API para consultar multas do DETRAN-RJ?
Sim. O InfraJus expõe uma API REST autenticada por chave onde o sistema do escritório cadastra o condutor e recebe o extrato completo em JSON: multas, pontuação e processos de suspensão e cassação. Não é preciso adotar a plataforma inteira para usar só a consulta.
A consulta é síncrona?
Não. O portal do DETRAN-RJ exige resolução de desafio anti-robô, tem limite de ritmo e fica instável com frequência, então uma consulta completa leva de 1 a 5 minutos. O fluxo é em duas etapas: o POST enfileira a consulta e responde na hora, e o GET devolve o JSON quando termina.
Como sei que o resultado é da minha consulta e não de uma anterior?
O campo de status só passa para concluída quando o extrato corresponde à consulta que você pediu. Enquanto houver consulta em andamento, o status permanece em fila mesmo que já exista um extrato anterior disponível, e a resposta explica isso no campo de avisos.
O que acontece se a consulta falhar no DETRAN?
A API entrega o último extrato válido que existe, mantém o status em fila e informa que a tentativa mais recente não completou. O sistema re-tenta automaticamente, sem consumir cota adicional e sem exigir novo POST.
Existe limite de consultas?
Sim. Cada chave tem um teto de rajada por minuto e uma cota diária definida em contrato. A cota conta raspagens efetivamente disparadas: leituras de resultado não consomem cota, e reenviar o mesmo CPF dentro de 12 horas reaproveita o extrato sem gerar nova consulta.
Quem é responsável pelos dados consultados?
O escritório que envia o CPF é o controlador dos dados e declara ter base legal para a consulta, normalmente por procuração do titular. O InfraJus atua como operador, tratando os dados apenas para executar a consulta contratada.
Quer testar a integração?
A gente emite uma chave de avaliação e acompanha a primeira consulta junto com o seu time de tecnologia.