Face API
v1EstávelReconhecimento facial e biometria
Visão Geral
Enrole rostos, realize buscas por similaridade e verifique identidades em tempo real com alta precisão.
Documentação
Autenticação
API Key com escopo face:read e face:write passada no header X-Api-Key.
Enroll
Envie imagem JPEG/PNG (min 200×200px). Retorna faceId para uso em verify/identify.
Verificação 1:1
Compara dois rostos e retorna score de similaridade (0–1) e is_match.
Webhooks
Receba eventos de identificação em tempo real via webhook configurável.
Referência da API
POST
/v1/persons/{cpf}/facesPOST
/v1/faces/verifyPOST
/v1/faces/identifyGET
/v1/largegroupsDELETE
/v1/persons/{cpf}/facesexemplo.ts
sandbox
// Verificação facial 1:1
const response = await fetch(
'https://api.smartpoint.app.br/v1/faces/verify',
{
method: 'POST',
headers: { 'X-Api-Key': 'SUA_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({ cpf: '000.000.000-00', faceImage: '<base64>' }),
}
);
const { is_match, score } = await response.json();