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

Requisição HTTP (Assíncrona)

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

Requisição HTTP (Síncrona) 🆕

Atenção

Este recurso é desabilitado por padrão. Para utilizá-lo, entre em contato com o suporte para solicitar a ativação.

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

dica

Utilize o modo síncrono para validações de identidade em tempo real durante o onboarding de usuários. A resposta segue o padrão detalhado em Estruturas de Resposta.

Corpo 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	Arquivo contendo rosto(s) (Formatos aceitos: PDF, JPG, PNG, TIFF, TIF, JPEG. Tamanho máximo: 15MB.)
imageFile2	multipart/image	Não	Segundo arquivo para comparação (Formatos aceitos: PDF, JPG, PNG, TIFF, TIF, JPEG. Tamanho máximo: 15MB.)
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 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.

Perguntas Frequentes

• Como a verificação facial (Face Match) funciona?