Buscar persona

Sube imágenes faciales para buscar personas inscritas por similitud (1:N).

menu_bookReferencia API: búsqueda facial (1:N)expand_more

Documentación oficial: docs.verifik.co/biometrics/search (búsqueda facial por imagen frente a personas inscritas).

URL base https://api.verifik.co. Envía una o más imágenes en base64 del mismo sujeto en images (sin prefijo data URL). Opcionalmente limita con collection_id. La documentación pública recomienda 1–3 imágenes para mejor recall.

POST /v2/face-recognition/search

Identificación 1:N: devuelve candidatos ordenados por puntuación de similitud.

Cabecera	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parámetro	Obl.	Descripción
images	Sí	Array de imágenes faciales en base64 (misma persona; se sugieren hasta ~3)
min_score	Sí	Umbral de coincidencia (p. ej. 0,2–1,0)
search_mode	Sí	FAST o ACCURATE
collection_id	No	Limitar la búsqueda a una colección
max_results	No	Tope de coincidencias devueltas (si se omite, aplica el valor por defecto de la API)

await fetch("https://api.verifik.co/v2/face-recognition/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    images: ["<base64>", "<base64>"],
    collection_id: "<optionalCollectionMongoId>",
    min_score: 0.75,
    search_mode: "FAST",
  }),
});

Esta demo usa searchPerson de @humanauthn/api-client con tu token de sesión.
Las respuestas suelen incluir coincidencias ordenadas y pueden incluir un bloque signature según el entorno.

menu_book

Guías oficiales en docs.verifik.co

Object

El objeto Person

Campos y estructura de un registro de persona en reconocimiento facial.

GET

Listar todas las personas

Personas de tu cliente, con filtros opcionales.

GET

Obtener una persona

Una persona por id.

PUT