Recuperar una Persona

Endpoint

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

Este endpoint te permite consultar una persona almacenada por la clave primaria.

Encabezados

Content-Type

Tipo: String
Requerido: Requerido
Valor: application/json

Authorization

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

Parámetros

id

Tipo: String
Requerido: Sí

ID de la persona de la cual deseas obtener la información.

Solicitud

Node.js

import axios from 'axios';

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

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

Python

import http.client

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

headers = {
    'Accept': "application/json",
    'Authorization': "JWT token"
}

conn.request("GET", "/v2/face-recognition/persons/person_123456789", headers=headers)

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

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

PHP

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.verifik.co/v2/face-recognition/persons/person_123456789', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'JWT token',
  ],
]);

echo $response->getBody();

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://api.verifik.co/v2/face-recognition/persons/person_123456789"

	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Add("Accept", "application/json")
	req.Header.Add("Authorization", "JWT token")

	client := &http.Client{}
	res, _ := client.Do(req)
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

Respuesta

200

{
  "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"
  }
}

404

{
  "error": "Persona no encontrada",
  "message": "PERSON_NOT_FOUND"
}

401

{
  "error": "No autorizado",
  "message": "UNAUTHORIZED"
}

Características

• Recuperación de Persona: Recupera registros específicos de personas por identificador único
• Información Completa: Detalles completos de la persona incluyendo imágenes y codificaciones
• 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