Serviços / Documentos

Leitura de documentos de identidade

POST/api/v1/oracle/document/identify

Lê os dois lados do RG — ou a CNH — numa chamada só e devolve o nome do titular, a filiação e a naturalidade.

Informe document_type e envie a CNH em document_front; o RG vai em document_front e document_back, e a ordem das imagens não importa.

Para CPF, número do documento, datas e órgão expedidor, use a Leitura de documentos.

Fonte: OCR com visão computacional · tempo real

Parâmetros

document_frontfileObrigatório

CNH, ou a frente do RG.

file
document_backfileOpcional

Verso do RG. Obrigatório quando o tipo é RG.

file
document_typestringObrigatório

Tipo do documento enviado.

CNH
query

Campos da resposta

Tipo solicitado

requested_document_type

string

Tipo identificado

document_type

string

Arquivo (frente)

filename

string

Arquivo (verso)

filename_2

string

Campos extraídos

analysis_result

object

Documento reconhecido

analysis_result.is_valid

boolean

Nome

analysis_result.nome

string

Filiação 1

analysis_result.filiacao1

string

Filiação 2

analysis_result.filiacao2

string

Cidade de nascimento

analysis_result.birth_city

string

UF

analysis_result.uf

string

Exemplo de resposta

Modelo de resposta: DocumentIdentifyOutput
JSON · response
{
  "success": true,
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": null,
  "data_count": 1,
  "data": [
    {
      "requested_document_type": "RG-FRONT",
      "document_type": "RG-TOTAL",
      "filename": "rg-frente.jpg",
      "filename_2": "rg-verso.jpg",
      "analysis_result": {
        "is_valid": true,
        "nome": "FULANO DE TAL DA SILVA",
        "filiacao1": "JOSE DE TAL DA SILVA",
        "filiacao2": "MARIA DE TAL DA SILVA",
        "birth_city": "SAO PAULO",
        "uf": "SP"
      }
    }
  ]
}

Casos de uso

KYC com RG

Ler os dois lados do RG numa chamada só, com a orientação conferida — o usuário fotografa na ordem que quiser.

Identificação no onboarding

Confirmar nome e filiação do titular no primeiro passo do cadastro, antes da comparação facial.