Actualizar una Persona

Endpoint

PUT https://api.verifik.co/v2/face-recognition/persons/{id}

Este endpoint te permite actualizar la información de una persona existente en el sistema de reconocimiento facial.

Encabezados

Nombre	Valor
Accept	application/json
Authorization	Bearer <token>

Parámetros de Ruta

Nombre	Tipo	Requerido	Descripción
id	string	Sí	ID de la persona a actualizar

Parámetros del Cuerpo

Nombre	Tipo	Requerido	Descripción
name	string	No	Nombre completo de la persona
images	array	No	1–3 imágenes en Base64. Reemplazan todas las caras enroladas (no se agregan a las anteriores).
gender	string	No	Género de la persona (M o F)
date_of_birth	string	No	Fecha de nacimiento de la persona (ISO8601)
nationality	string	No	Nacionalidad de la persona
collections	array	No	Array de IDs de colección relacionados con esta persona
notes	string	No	Notas adicionales sobre la persona

Ejemplo de Solicitud

Node.js

import axios from 'axios';

const options = {
  method: 'PUT',
  url: 'https://api.verifik.co/v2/face-recognition/persons/person_123456789',
  data: {
    name: "John Doe Updated",
    gender: "M",
    date_of_birth: "1990-01-15",
    nationality: "US",
    notes: "Cliente VIP - Actualizado"
  },
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer <your_token>'
  }
};

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

Python

import http.client
import json

conn = http.client.HTTPSConnection("api.verifik.co")

payload = json.dumps({
  "name": "John Doe Updated",
  "gender": "M",
  "date_of_birth": "1990-01-15",
  "nationality": "US",
  "notes": "Cliente VIP - Actualizado"
})

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer <your_token>",
    'Content-Type': 'application/json'
}

conn.request("PUT", "/v2/face-recognition/persons/person_123456789", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "_id": "person_123456789",
    "name": "John Doe Updated",
    "gender": "M",
    "date_of_birth": {
      "year": 1990,
      "month": 1,
      "day": 15
    },
    "nationality": "US",
    "collections": ["collection_123456789"],
    "notes": "Cliente VIP - Actualizado",
    "client": "client_123456789",
    "status": "active",
    "updatedAt": "2024-01-15T11:30:00Z"
  }
}

Notas

• Si envías images, usa 1–3 strings en Base64. Ese conjunto reemplaza las caras enroladas; no se suma al recorte anterior. Payloads muy cortos pueden devolver 412 only_images_in_base64. Para conservar una pose antigua y agregar una nueva, envía ambas imágenes en la misma solicitud.