Listar Todas las Colecciones

Endpoint

GET https://api.verifik.co/v2/face-recognition/collections

Obtén todas las colecciones generadas por un cliente específico. El único parámetro requerido es enviar el token de acceso. Con esto, Verifik identificará las colecciones generadas por este usuario.

Encabezados

Nombre	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción
—	—	—	Sin parámetros de ruta ni query. El alcance lo define el cliente del token Bearer.

Solicitud

Node.js

const fetch = require("node-fetch");

async function run() {
  const res = await fetch("https://api.verifik.co/v2/face-recognition/collections", {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
    },
  });
  console.log(await res.json());
}

run();

PHP

<?php
$ch = curl_init("https://api.verifik.co/v2/face-recognition/collections");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python

import os, requests

url = "https://api.verifik.co/v2/face-recognition/collections"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"
}
r = requests.get(url, headers=headers)
print(r.json())

Go

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.verifik.co/v2/face-recognition/collections", nil)
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer "+os.Getenv("VERIFIK_TOKEN"))
    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    var out map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&out)
    fmt.Println(out)
}

Respuesta

200

{
    "data": [
        {
            "_id": "65b9592267cc4f096dbe743d",
            "deleted": false,
            "name": "Ejemplo Ene 30",
            "project": "65b955fe0577440932c77481",
            "description": "default collection for project 65b955fe0577440932c77481",
            "client": "6158e492dd0767a2b8b3f829",
            "code": "d96db430-27d2-4f43-bcff-c4b239ac6d2e",
            "updatedAt": "2024-01-30T20:16:34.841Z",
            "createdAt": "2024-01-30T20:16:34.841Z",
            "__v": 0
        },
        {
            "_id": "65c2a9364d8e8d3917eaf383",
            "deleted": false,
            "name": "Ejemplo Feb 6",
            "project": "65c2a9271ff6bd3955eececd",
            "description": "default collection for project 65c2a9271ff6bd3955eececd",
            "client": "6158e492dd0767a2b8b3f829",
            "code": "548574d7-748c-4a75-8838-aa9aa59b00d5",
            "updatedAt": "2024-02-06T21:48:39.240Z",
            "createdAt": "2024-02-06T21:48:39.240Z",
            "__v": 0
        }
    ]
}

401/403

{
    "message": "Access forbidden",
    "code": "Forbidden"
}

400

{
  "error": "Invalid request"
}

Notas

• Autenticación: el token Bearer determina qué colecciones de cliente se devuelven.
• Formato: las respuestas correctas envuelven el arreglo en data.
• Filtros: este endpoint no acepta query; devuelve las colecciones visibles para el cliente.