O que a comparação entrega
O Face Match recebe a imagem de um documento e uma selfie e compara os rostos. Na resposta do serviço, verified indica o resultado da comparação; distance e threshold ajudam a interpretar esse resultado conforme o contrato. Isso não transforma a foto em uma prova de identidade completa.
Prepare a captura antes da API
A integração começa na experiência de envio. Oriente o usuário a fotografar o documento inteiro, evitar reflexos e manter o rosto visível. Na selfie, prefira iluminação uniforme e enquadramento claro. Um arquivo recortado ou ilegível deve poder ser reenviado.
- Valide tamanho e formato do arquivo no seu backend.
- Armazene os arquivos apenas pelo tempo necessário ao fluxo.
- Se necessário, use detecção e recorte de rosto antes da comparação.
Envie documento e selfie
O endpoint POST /api/v1/oracle/face/verify recebe doc_photo e selfie em multipart/form-data. A autenticação usa HTTP Basic com a chave pública e o segredo. A chamada deve sair do backend: a chave secreta não pode aparecer no JavaScript entregue ao usuário.
No Playground, comece pelo modo DEV para conhecer o contrato. Depois, teste a execução real com imagens autorizadas, leia os erros e acompanhe a chamada pelo log_id. O catálogo apresenta os parâmetros e o preço vigente.
Defina o que acontece depois
Uma comparação pode seguir para revisão em vez de encerrar o cadastro. Diferencie falha técnica, problema de qualidade e resultado da comparação: cada situação pede uma mensagem e um próximo passo próprios.
Registre a regra aplicada e ofereça uma alternativa quando a imagem não puder ser tratada. Combine a comparação com a conferência dos dados do documento e com as demais etapas necessárias ao seu produto.
O próximo passo está na API.
Conheça os campos, os exemplos e as regras de cada serviço antes de integrar.
Conhecer o produto
