Buscar usuario activo
Búsqueda 1:N sin prueba de vida, para flujos de usuario activo o de sesión (una imagen de consulta).
menu_bookReferencia API: búsqueda facial 1:N (usuario activo)expand_more
Documentación oficial: docs.verifik.co/biometrics/search-active-user (búsqueda 1:N sin prueba de vida—flujos de sesión o usuario activo).
URL base https://api.verifik.co. Envía una imagen en base64 en image, os obligatorio (ANDROID, IOS o DESKTOP), más min_score y search_mode. Esta demo usa DESKTOP.
POST /v2/face-recognition/search-active-user
Similar a la búsqueda en vivo, pero sin paso de vida: úsala cuando el usuario ya está en sesión autenticada o de confianza.
| Cabecera | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Parámetro | Obl. | Descripción |
|---|---|---|
| image | Sí | Una sola imagen de consulta en base64 |
| os | Sí | ANDROID, IOS o DESKTOP |
| min_score | Sí | Umbral de coincidencia (0,5–1,0) |
| search_mode | Sí | FAST o ACCURATE |
| collection_id | No | Limitar la búsqueda a una colección |
await fetch("https://api.verifik.co/v2/face-recognition/search-active-user", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
image: "<base64>",
os: "DESKTOP",
min_score: 0.75,
search_mode: "FAST",
collection_id: "<optionalCollectionMongoId>",
}),
});- Esta demo usa searchActiveUser de @humanauthn/api-client con tu token de sesión.
- Para vida + 1:N, usa search-live-face (ver búsqueda 1:N en vivo en la documentación).
Documentación relacionada
Guías oficiales en docs.verifik.co
El objeto Person
Campos y estructura de un registro de persona en reconocimiento facial.
Listar todas las personas
Personas de tu cliente, con filtros opcionales.
Obtener una persona
Una persona por id.
Actualizar una persona
Perfil, imágenes, colecciones y más.
Eliminar una persona
Elimina un registro de persona por id.
Búsqueda facial 1:N (usuario activo)
Búsqueda 1:N sin prueba de vida para flujos de sesión o usuario activo.