Crear Persons (POST)

La API de Creación de Personas te permite crear una nueva persona dentro del sistema de reconocimiento facial. Puedes asociar una persona con su nombre, imágenes, género, fecha de nacimiento, nacionalidad, colecciones y notas adicionales.

Para crear una nueva persona, realiza una solicitud POST al endpoint /v2/face-recognition/persons con los parámetros requeridos en el cuerpo de la solicitud, incluyendo el nombre de la persona, imágenes, género, fecha de nacimiento, nacionalidad, colecciones y notas adicionales.

La API responderá con información sobre la persona recién creada, incluyendo su identificador único, nombre, género, fecha de nacimiento, nacionalidad, miniaturas asociadas, colecciones y marcas de tiempo. Esta información se puede utilizar para diversas tareas de reconocimiento e identificación facial, incluyendo la gestión de perfiles de usuarios y la incorporación de individuos en tu sistema de reconocimiento facial.

NOTA: El parámetro images es un array en el cual se pueden enviar hasta 3 imágenes de una misma persona, si no son de la misma el sistema no creará de manera correcta al usuario.

Implementación

Consulta

import axios from 'axios';

const options = {
  method: 'POST',
  url: '<https://api.verifik.co/v2/face-recognition/persons>',
  params: {
  },
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  },
  data: {
    name: 'Mateo Verifik',
    notes: 'Verifik employee',
    gender: 'M',
    images: ['Base 64 Image'],
    collections: ['8e3ee8df-7fb3-av13-8a13-7b00f2beca6a'],
    nationality: 'Colombian',
    date_of_birth: '1995-05-07'
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Respuesta 200 - (Consulta Exitosa)

{
  "data": {
    "__v": 0,
    "_id": "6517684fe09925fabe13bva9",
    "name": "Mateo Verifik",
    "notes": "Verifik employee",
    "client": "64404b1f9856cc8cebd762e7",
    "gender": "M",
    "deleted": false,
    "createdAt": "2023-09-30T00:14:08.329Z",
    "updatedAt": "2023-09-30T00:14:08.329Z",
    "thumbnails": [
      {
        "id": "c1e0fb47-3d7a-4e67-994f-7a3da8be1c88",
        "thumbnail": "Base 64 Image"
      }
    ],
    "collections": [
      "Test"
    ],
    "nationality": "Colombian",
    "date_of_birth": "1995-05-07T00:00:00.000Z"
  }
}

Obtener Persons (GET)

Servicio para buscar todas las personas creadas por un cliente independientemente a la colección a la que pertenezcan, como único parámetro se requiere proporcionar el access token, con el Verifik hará el respectivo filtro para retornar la información de manera adecuada.

Verifik ofrece una guía sobre cómo crear y gestionar Persons. Le invitamos a leerla: Guía Collection y Persons.

La respuesta contiene un conjunto de objetos de persona, cada uno representando a un individuo en el sistema. Puedes recorrer este conjunto para acceder y utilizar la información sobre cada persona según sea necesario para tu aplicación.

Implementación

Consulta

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/face-recognition/persons>',
  params: {
  },
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}