Skip to main content

Crear una Persona

Endpoint​

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

La API de Crear Persona 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.

Encabezados​

Content-Type​

Tipo: String
Requerido: Requerido
Valor: application/json

Authorization​

Tipo: String
Requerido: Requerido
Valor: Bearer <token>

Parámetros​

name​

Tipo: String
Requerido: Sí

Nombre completo de la persona.

images​

Tipo: Array de String
Requerido: Sí

1–3 imágenes en Base64 (sin prefijo data:). Enviar más de una pose (frente + un poco de perfil + otra luz) hace el enrolamiento más robusto.

gender​

Tipo: String
Requerido: No

Género de la persona (M o F).

date_of_birth​

Tipo: String (ISO8601)
Requerido: No

Fecha de nacimiento de la persona.

nationality​

Tipo: String
Requerido: No

Nacionalidad de la persona.

collections​

Tipo: Array de String
Requerido: No

Array de IDs de colección relacionados con esta persona.

notes​

Tipo: String
Requerido: No

Notas adicionales sobre la persona.

Solicitud​

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://api.verifik.co/v2/face-recognition/persons',
  data: {
    name: "John Doe",
    images: [
      "base64_encoded_image_1",
      "base64_encoded_image_2"
    ],
    gender: "M",
    date_of_birth: "1990-01-15",
    "nationality": "US",
    "collections": ["collection_123456789"],
    "notes": "Cliente VIP"
  },
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

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

Ejemplo de Respuesta​

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "JWT token",
  "Content-Type": "application/json"
]

let parameters = [
  "name": "John Doe",
  "images": [
    "base64_encoded_image_1",
    "base64_encoded_image_2"
  ],
  "gender": "M",
  "date_of_birth": "1990-01-15",
  "nationality": "US",
  "collections": ["collection_123456789"],
  "notes": "Cliente VIP"
] as [String : Any]

let postData = try? JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/face-recognition/persons")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

Respuesta​

{
  "success": true,
  "data": {
    "_id": "person_123456789",
    "name": "John Doe",
    "gender": "M",
    "date_of_birth": {
      "year": 1990,
      "month": 1,
      "day": 15
    },
    "nationality": "US",
    "images": [
      "base64_encoded_image_1",
      "base64_encoded_image_2"
    ],
    "collections": ["collection_123456789"],
    "notes": "Cliente VIP",
    "client": "client_123456789",
    "status": "active",
    "faceEncodings": [
      "face_encoding_1",
      "face_encoding_2"
    ],
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:30:00Z"
  }
}

Características​

  • Creación de Persona: Crea nuevos individuos en el sistema de reconocimiento facial
  • Carga de Imágenes: Soporte para múltiples imágenes codificadas en Base64
  • Asignación de Colección: Asigna personas a colecciones específicas
  • Procesamiento Automático: Las codificaciones faciales se generan automáticamente
  • Respuesta Estructurada: Formato de datos organizado para fácil integración
  • Múltiples Lenguajes de Programación: Soporte para JavaScript, Python, PHP y Swift
  • Manejo de Errores: Respuestas de error completas para varios escenarios