Listar Todas las Personas

Endpoint

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

Este endpoint te permite traer todas las personas almacenadas en Verifik para todas las colecciones.

Encabezados

Content-Type

Tipo: String
Requerido: Requerido
Valor: application/json

Authorization

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

Parámetros de Consulta

page

Tipo: Number
Requerido: No

Número de página para paginación (predeterminado: 1).

limit

Tipo: Number
Requerido: No

Número de registros por página (predeterminado: 10, máximo: 100).

collection

Tipo: String
Requerido: No

Filtrar por ID de colección específico.

status

Tipo: String
Requerido: No

Filtrar por estado: active, inactive, pending.

populates[]

Tipo: String
Requerido: No

Array opcional de datos relacionados a incluir. Opciones disponibles: collections, client.

Solicitud

Node.js

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/face-recognition/persons',
  params: {
    page: 1,
    limit: 10,
    status: "active",
    "populates[]": ["collections"]
  },
  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?page=1&limit=10&status=active&populates[]=collections", 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?page=1&limit=10&status=active&populates[]=collections', [
  '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?page=1&limit=10&status=active&populates[]=collections"

	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": [
        {
          "_id": "collection_123456789",
          "name": "Clientes VIP",
          "description": "Clientes de alto valor"
        }
      ],
      "notes": "Cliente VIP",
      "client": "client_123456789",
      "status": "active",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "pages": 1
  }
}

400

{
  "success": false,
  "error": "Parámetros de consulta inválidos",
  "code": "INVALID_PARAMETERS"
}

Características

• Recuperación de Lista de Personas: Recupera todas las personas con información detallada
• Soporte de Paginación: Navega a través de grandes conjuntos de datos con paginación basada en páginas
• Opciones de Filtrado: Filtra por colección, estado y otros criterios
• Soporte de Población: Incluye información de colección y cliente relacionada
• 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