IdFace gera um identificador único a partir de uma selfie. O usuário não digita nem declara um identificador de nenhuma outra forma — a identidade é o resultado da chamada, não a entrada. Em uma correspondência bem-sucedida, a resposta retorna um person_id estável e opaco que identifica o usuário de forma exclusiva entre os processos.
O que faz
A partir da selfie capturada, o IdFace gera um identificador biométrico estável e opaco (person_id) que representa de forma exclusiva aquele rosto. O usuário não declara nenhum identificador — a identidade é o resultado da chamada, não a entrada. Em cada correspondência bem-sucedida, a resposta retorna o mesmo person_id, permitindo que o mesmo usuário seja reconhecido em processos futuros.
Entradas
A selfie é capturada pelo SDK ou pela jornada Web. Para integração via API headless, a imagem é enviada como imagebase64 no corpo de POST /v1/process com flow=idface. Não inclua subject.code — o IdFace retorna o person_id na resposta.
Para garantir que a imagem enviada via API atenda aos requisitos biométricos, utilize o SDK da Unico para sua plataforma ou siga o Padrão de Captura. O IdFace não aceita imagens arbitrárias sem controle de qualidade de captura.
Respostas possíveis
idFace.result | Significado |
|---|---|
FOUND | Identidade confirmada. person_id está retornado e preenchido. |
NOT_FOUND | Identidade não confirmada. person_id estará ausente. |
Exemplo de resposta
{
"id": "1c1fc38b-7e98-4f9a-a04d-7a4a8b29d2c1",
"status": 3,
"idFace": {
"person_id": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
"result": "FOUND"
}
}
person_id é um identificador estável e opaco — o mesmo usuário sempre resolverá para o mesmo valor. Armazene-o junto ao registro do seu usuário para reconhecer a mesma pessoa em chamadas subsequentes ao IdFace.
Disponibilidade
| Superfície | Suportado |
|---|---|
| SDK (Android, iOS, Flutter) | ✅ |
| Web (iFrame, Redirect) | ✅ |
| API (headless, sem SDK) | ✅ |