Crear una Colección

Endpoint

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

Crea una nueva colección para almacenar rostros generados utilizando los servicios de Detección de Vida de Verifik. Las colecciones son necesarias para la mayoría de los servicios biométricos.

Encabezados

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

Parámetros

Nombre	Tipo	Requerido	Descripción
name	string	Sí	Nombre visible de la colección
description	string	No	Descripción opcional

Solicitud

Node.js

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

async function run() {
  const res = await fetch("https://api.verifik.co/v2/face-recognition/collections", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
    },
    body: JSON.stringify({
      name: "Ejemplo de prueba",
      description: "Ejemplo de cómo crear una colección",
    }),
  });
  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_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "name" => "Ejemplo de prueba",
    "description" => "Ejemplo de cómo crear una colección",
]));
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')}",
}
payload = {
    "name": "Ejemplo de prueba",
    "description": "Ejemplo de cómo crear una colección",
}
r = requests.post(url, json=payload, headers=headers)
print(r.json())

Go

package main

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

func main() {
    payload, _ := json.Marshal(map[string]string{
        "name":        "Ejemplo de prueba",
        "description": "Ejemplo de cómo crear una colección",
    })
    req, _ := http.NewRequest("POST", "https://api.verifik.co/v2/face-recognition/collections", bytes.NewReader(payload))
    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": {
    "__v": 0,
    "_id": "65175da13e81e4fabc12345",
    "code": "dac2c81b-96a6-4f19-ab54-d1a72d55b64b",
    "name": "Ejemplo de prueba",
    "client": "65175da13e81e4fabc12345",
    "deleted": false,
    "createdAt": "2023-09-29T23:28:33.894Z",
    "updatedAt": "2023-09-29T23:28:33.894Z",
    "description": "Ejemplo de cómo crear una colección"
  }
}

401/403

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

409

{
  "message": "Validation message from server",
  "code": "MissingParameter"
}

400

{
  "error": "Invalid request"
}

Notas

• Autenticación: envía un token válido; la colección queda asociada a tu cliente.
• Nombre: name es obligatorio; description es opcional pero recomendable.
• Errores: 409 / MissingParameter suele indicar cuerpo incompleto o inválido según la validación de la API.