IdFace genera un identificador único a partir de un selfie. El usuario no escribe ni declara un identificador de ninguna otra manera — la identidad es el resultado de la llamada, no el dato de entrada. Ante una coincidencia exitosa, la respuesta devuelve un person_id estable y opaco que identifica de forma unívoca al usuario en todos los procesos.
Qué hace
A partir del selfie capturado, IdFace genera un identificador biométrico estable y opaco (person_id) que representa de forma única ese rostro. El usuario no declara ningún identificador — la identidad es el resultado de la llamada, no el dato de entrada. En cada coincidencia exitosa, la respuesta devuelve el mismo person_id, lo que permite reconocer al mismo usuario en procesos futuros.
Entradas
El selfie es capturado por el SDK o el journey Web. Para integración headless vía API, la imagen se envía como imagebase64 en el cuerpo de POST /v1/process con flow=idface. No incluyas subject.code — IdFace devuelve el person_id en la respuesta.
Para garantizar que la imagen enviada vía API cumpla con los requisitos biométricos, usa el SDK de Unico para tu plataforma o sigue el Estándar de Captura. IdFace no acepta imágenes arbitrarias sin control de calidad de captura.
Posibles respuestas
idFace.result | Significado |
|---|---|
FOUND | Identidad confirmada. person_id se devuelve y está disponible. |
NOT_FOUND | Identidad no confirmada. person_id estará ausente. |
Ejemplo de respuesta
{
"id": "1c1fc38b-7e98-4f9a-a04d-7a4a8b29d2c1",
"status": 3,
"idFace": {
"person_id": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
"result": "FOUND"
}
}
person_id es un identificador estable y opaco — el mismo usuario siempre resolverá al mismo valor. Almacénalo junto al registro del usuario para reconocer a la misma persona en llamadas posteriores a IdFace.
Disponibilidad
| Superficie | Compatible |
|---|---|
| SDK (Android, iOS, Flutter) | ✅ |
| Web (iFrame, Redirect) | ✅ |
| API (headless, sin SDK) | ✅ |