Create a Person [With Liveness detection] (Crear una Persona [Con Detección de vida]

Endpoint

https://api.verifik.co/v2/face-recognition/persons/search-live-face

Servicio integral para la correcta creación de personas dentro de una colección, asegurando una gestión óptima de individuos a través del siguiente flujo de trabajo:

• Primero, realiza una búsqueda en la colección 1:N para garantizar que no se genere una persona duplicada dentro de la misma colección.

• Si no se encuentra una coincidencia almacenada en la colección, procede a realizar una Detección de Vida (Liveness Detection) en la selfie recibida.

• Una vez completados los pasos anteriores, el servicio crea con precisión una nueva persona dentro de la colección. Verifik garantiza que una nueva solicitud de persona con el mismo rostro se almacene realizando la búsqueda 1:N, además de ejecutar una prueba de liveness.

NOTA: El parámetro "images" es un array en el que se pueden enviar hasta 3 imágenes de la misma persona. Si las imágenes no corresponden a la misma persona, el sistema no creará correctamente el usuario.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Parameters

Parameter	Type	Required	Description
name	String	Yes	Full name of the person
collection_id	String	Yes	The unique identifier for the collection in which the person will be added.
images	Array	Yes	An array containing Base64-encoded images of the person. You can send up to 3 images of the same person. Images must be Base64-encoded strings.
notes	String	No	Optional notes or remarks about the person (e.g., employment status, additional details).
date_of_birth	String	No	The person's date of birth in YYYY-MM-DD format.
nationality	String	No	The person's nationality (e.g., "Colombian").
gender	String	No	The person's gender. Accepted values: "M" (Male), "F" (Female).
min_score	Float	No	The minimum score for face matching (Search 1:N), ranging from 0 to 1. A higher value requires a stronger match to avoid duplicates. Default is usually around 0.8.
search_mode	String	No	Defines the search speed. Accepted values: "FAST" (faster but potentially less accurate), "ACCURATE" (slower but more precise). we set as default "FAST"
liveness_min_score	Float	No	The minimum liveness score, ranging from 0 to 1. A value of 0.65 is typical, where values closer to 1 increase strictness in confirming liveness.

Request

Node.js

const axios = require('axios');
let data = JSON.stringify({
  "name": "Juan Miguel Trevino Morales",
  "images": [
    "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAYGBgYHB...dz/9k="
  ],
  "gender": "M",
  "date_of_birth": "1992-03-02",
  "nationality": "Mexican",
  "notes": "Created via API",
  "collection_id": "b26cb8c3-0778-4ec5-8bc4-a7cac66b5291",
  "liveness_min_score": 0.7,
  "min_score": 0.67,
  "search_mode": "FAST"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.verifik.co/v2/face-recognition/persons/search-live-face',
  headers: { 
    'Authorization': 'Bearer eyJhbGciOiJIUzkpXVCJ9.eyJjbGllbnRJZC...4Cw', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

PHP

<?php
$client = new Client();
$headers = [
  'Authorization' => 'Bearer eyJhbGc5cCIVCJ9.eyJjbGllbn...lt4Cw',
  'Content-Type' => 'application/json'
];
$body = '{
  "name": "Juan Miguel Trevino Morales",
  "images": [
    "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAYGBgY.../8AJWOKZadz/9k="
  ],
  "gender": "M",
  "date_of_birth": "1999-09-22",
  "nationality": "Mexican",
  "notes": "Created via API",
  "collection_id": "b26cb8c3-0778-4ec5-8bc4-a7cac66b5291",
  "liveness_min_score": 0.7,
  "min_score": 0.67,
  "search_mode": "FAST"
}';
$request = new Request('POST', 'https://api.verifik.co/v2/face-recognition/persons/search-live-face', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

Swift

let parameters = "{\n    \"name\": \"Juan Miguel Trevino Morales\",\n    \"images\": [\n        \"/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAYGBgYHBF2oQrUJ+xwcsQOnBYrMsEQf1GWBzURqVSSgM8VC0ZZTb+oBk4xHcFhW0gV8OM8q1iW3yQZaR5/vDCVmCGyprhuqjUqA1C4S4bzxWbGL6lwfXCxTAZTwcKXqji/hmZ4uLKnjjvkWWcXhn5wQ1PPFY+FJx7jfeJg4vEI8PKO43jlcQu8xvHBzZXGJZ1LgmOmWwZRznRxUFlTXmamTuNSu1zqXL4MnNw31wQ1xWOfUbeDr42VgYkCE08e+CDUPgVHhjqZ4/YZIDUwi/6jN8DrnKTFTHxIkrM7jwrXHctwQlzqO4wNQjx1x1B03Lbl55uVxdwOLYRpodQ3L4vgxDO5l4yMZcNzcYS+M0S++Ca64uEdvjm8z1NyoVDMDMrNz6hCfsoHdQY1ouWXln1csYe5ZgE1KJfDcYXcw4zfw6413wSp9y5c3EYQcwiVK4KSZ646lMwR1cU0ykeDgNzv3NuHjrjMqXUpfgYm2OIEFMfBhMwq/U3PGZUqpR55KeNzriuenEJXm+MkohEmo47Iw1x7m+OjFzCy2j1Lmb1LxUt1zULzw8ErtY71Kw83MSiGeUJgj1Ll9VC+iOJc/8AJWOKZadz/9k=\"\n    ],\n\t\"gender\": \"M\",\n\t\"date_of_birth\": \"1992-03-02\",\n\t\"nationality\": \"Mexican\",\n\t\"notes\": \"Created via API\",\n    \"collection_id\": \"b26cb8c3-0778-4ec5-8bc4-a7cac66b5291\",\n    \"liveness_min_score\": 0.7,\n    \"min_score\": 0.67,\n    \"search_mode\": \"FAST\"\n}"
let postData = parameters.data(using: .utf8)

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/face-recognition/persons/search-live-face")!,timeoutInterval: Double.infinity)
request.addValue("Bearer eyJhbGciIkpXVCJ9.eyJjbGllbnRjI4O...V0w1splt4Cw", forHTTPHeaderField: "Authorization")
request.addValue("application/json", forHTTPHeaderField: "Content-Type")

request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()