Crear persona

Registra una nueva persona con imágenes faciales y metadatos.

menu_bookReferencia de API: crear personaexpand_more

Documentación oficial: docs.verifik.co/resources/create-a-person

URL base https://api.verifik.co. Envía JSON con campos de perfil y al menos una imagen facial en base64 por entrada en images (sin prefijo data URL). La documentación pública también lista campos opcionales como notes, email y phone.

POST /v2/face-recognition/persons

Registra una nueva persona en los ids de colección indicados (valores _id de colección) con biometría facial para reconocimiento Verifik.

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 (obligatorio en esta demo)
date_of_birth	Sí	YYYY-MM-DD (obligatorio en esta demo)
collections	Sí	Arreglo de strings _id de colección; esta demo las carga con GET /v2/face-recognition/collections y permite elegir una o más.
nationality	No	Código o etiqueta de país / nacionalidad opcional

await fetch("https://api.verifik.co/v2/face-recognition/persons", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    name: "Jane Doe",
    gender: "F",
    date_of_birth: "1990-01-15",
    collections: ["<collectionMongoId>"],
    nationality: "CO",
    images: ["<base64>", "<base64>"],
  }),
});

// 200 OK — example shape
{
  "data": {
    "id": "…",
    "name": "Jane Doe",
    "gender": "F",
    "date_of_birth": "1990-01-15",
    "collections": ["…"],
    "…": "…"
  }
}

Esta demo usa createPerson de @humanauthn/api-client con el token de tu sesión.
Las respuestas pueden incluir id y un bloque signature junto a data 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 de reconocimiento facial.

GET

Listar todas las personas

Personas de tu cliente, con filtros opcionales.

GET

Obtener una persona

Una sola persona por id.

PUT