Crear persona con liveness
Registro + comprobación de vida + búsqueda de duplicados en una sola llamada.
menu_bookReferencia de API: crear persona con livenessexpand_more
Documentación oficial (inglés): docs.verifik.co/resources/create-a-person-with-liveness
Documentación (español): docs.verifik.co/verifik-es/resources/personas/crear-una-persona-con-deteccion-de-vida
URL base https://api.verifik.co. Envía JSON con campos de perfil, un único collection_id (_id de colección), umbrales de liveness y búsqueda, y al menos una imagen facial en base64 por entrada en images (sin prefijo data URL).
POST /v2/face-recognition/persons/search-live-face
Ejecuta liveness sobre el o los rostros enviados, busca inscripciones similares y crea o actualiza una persona en la colección indicada.
| Cabecera | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Parámetro | Obl. | Descripción |
|---|---|---|
| name | Sí | Nombre para mostrar |
| images | Sí | Arreglo de imágenes faciales en base64 (base64 crudo, no data URLs) |
| gender | Sí | M o F |
| date_of_birth | Sí | YYYY-MM-DD |
| collection_id | Sí | Id único de una sola colección |
| liveness_min_score | Sí | 0.5–1 |
| min_score | Sí | Umbral interno de búsqueda, 0.5–1 |
| search_mode | Sí | FAST o ACCURATE |
| nationality | No | Opcional |
await fetch("https://api.verifik.co/v2/face-recognition/persons/search-live-face", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
name: "Jane Doe",
gender: "F",
date_of_birth: "1990-01-15",
collection_id: "<collectionMongoId>",
liveness_min_score: 0.65,
min_score: 0.8,
search_mode: "FAST",
nationality: "CO",
images: ["<base64>", "<base64>"],
}),
});- Esta demo usa createPersonWithLiveness de @humanauthn/api-client con el token de tu sesión.
- Las respuestas pueden incluir un bloque signature junto a data según el entorno.
Documentación relacionada
Guías oficiales en docs.verifik.co
El objeto Person
Campos y estructura de un registro de persona de reconocimiento facial.
Listar todas las personas
Personas de tu cliente, con filtros opcionales.
Obtener una persona
Una sola persona por id.
Actualizar una persona
Perfil, imágenes, colecciones y más.
Eliminar una persona
Elimina un registro de persona por id.
Crear persona con liveness
Liveness, búsqueda de duplicados y registro en una solicitud.
Actualizar persona (demo)
Cambia perfil o colecciones de un id de persona existente.
Eliminar persona (demo)
Eliminación total o quitar solo de una colección.