Comparação Facial (Face Match)

A API de Comparação Facial Assíncrona realiza a comparação biométrica entre imagens de documentos e fotos em tempo real utilizando visão computacional avançada.

Documentação Relacionada

• Autenticação

Endpoint Principal

POST https://api.santoid.com.br/api/v1/face-match-async

Estrutura da Requisição

{
    "imageFile1": "<multipart/image>",
    "imageFile2": "<multipart/image>",
    "track": "<string>",
    "sensitive_data_compliance": "<bool>",
    "customerRequestId": "<string>"
}

Modos de Operação

• Modo Duas Imagens: Quando imageFile2 é fornecido, compara rostos entre duas imagens distintas
• Modo Imagem Única: Quando apenas imageFile1 é enviado, detecta e compara múltiplas faces na mesma imagem

Parâmetros da Requisição

Campo	Tipo	Obrigatório	Descrição
imageFile1	multipart/image	Sim	Imagem contendo rosto(s) (Formatos: JPG, PNG, WEBP)
imageFile2	multipart/image	Não	Segunda imagem para comparação
track	string	Sim	ID da track de processamento configurada
sensitive_data_compliance	boolean	Sim	Consentimento explícito para processamento de dados biométricos
customerRequestId	string	Não	Identificador para rastreamento pelo cliente

Fluxo de Resposta

Recursos Complementares

• Exemplos completos de implementação
• Estrutura de webhooks para respostas

Casos de Uso Comuns

1. Onboarding Digital
   Valide a identidade do usuário comparando selfies com documentos oficiais

2. Autenticação Segura
   Substitua senhas por reconhecimento facial em processos sensíveis

3. Prevenção a Fraudes
   Detecte tentativas de uso de fotos ou vídeos em vez de pessoas reais

Dicas de Implementação

✅ Sempre obtenha consentimento explícito (sensitive_data_compliance)
✅ Utilize customerRequestId para rastrear solicitações no seu sistema
✅ Para maior precisão, envie imagens com boa iluminação e resolução

Comece agora mesmo com nossa documentação detalhada ou fale com nosso time técnico para implementações personalizadas.