Crear colección
Crea una colección con nombre para agrupar personas registradas.
menu_bookReferencia de API: crear colecciónexpand_more
Documentación oficial: docs.verifik.co/resources/create-a-collection
URL base https://api.verifik.co. Envía un cuerpo JSON con un nombre visible y una descripción opcional.
POST /v2/face-recognition/collections
Crea una colección con nombre para agrupar personas registradas para búsqueda y verificación en tu base Verifik.
| Cabecera | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Parámetro | Obl. | Descripción |
|---|---|---|
| name | Sí | Nombre visible de la colección |
| description | No | Descripción opcional |
await fetch("https://api.verifik.co/v2/face-recognition/collections", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
name: "My collection",
description: "Optional notes",
}),
});// 200 OK — example shape
{
"data": {
"_id": "…",
"code": "…",
"name": "My collection",
"description": "Optional notes",
"client": "…",
"createdAt": "…",
"updatedAt": "…",
"__v": 0
}
}- Esta demo usa createCollection de @humanauthn/api-client con tu token de sesión.
- Algunos entornos pueden añadir un id o un bloque signature en las respuestas; la forma anterior muestra el núcleo del payload data.
Documentación relacionada
Guías oficiales en docs.verifik.co
El objeto Collection
Campos y estructura de una colección de reconocimiento facial.
Listar todas las colecciones
Todas las colecciones del cliente autenticado.
Obtener una colección
Una colección por id.
Actualizar una colección
Nombre, descripción, proyecto opcional o lista de personas.
Eliminar una colección
Elimina una colección por id y limpia datos vinculados.