Como extrair dados de RG e CNH com uma API?

Da imagem ao dado estruturado

OCR permite ler texto em imagens e documentos. Em um fluxo de identidade, a leitura organiza os campos previstos no contrato para que sua aplicação não dependa da transcrição manual. É diferente de validar a autenticidade do documento ou confirmar quem está usando o cadastro.

Para RG e CNH, comece pelo serviço de leitura de documentos de identidade. A leitura geral serve a outros cenários; consultar o endpoint específico evita esperar campos que não fazem parte da resposta.

Uma boa captura evita retrabalho

1. Peça uma imagem inteira, sem cortes nos campos.
2. Oriente a captura com boa iluminação, sem reflexos.
3. Valide o formato aceito antes de enviar o arquivo.
4. Permita o reenvio quando a informação não estiver legível.

Integre a leitura pelo backend

Consulte o detalhe de oracle/document/identify para conferir o nome do arquivo, os parâmetros e o exemplo de resposta. Faça uma simulação no Playground e copie o request no formato que seu backend usa.

Na execução real, envie a chave por HTTP Basic e associe a chamada ao projeto com X-Project-Id. Guarde o segredo em uma variável de ambiente e use o log_id para investigar falhas sem registrar o documento em logs abertos.

Confira os campos antes de salvar

Separe erro de transporte, erro de leitura e campos ausentes. Nem todo documento oferece a mesma informação. Não preencha valores inventados para completar um cadastro: solicite confirmação quando o retorno não atender ao seu processo.

Se o próximo passo exigir comparar documento e selfie, integre Face Match como uma etapa própria. A leitura OCR, a comparação facial e a prova de vida têm finalidades diferentes.