/faces

Añade un nuevo espécimen (rostro) a la base de datos. Primero, se busca la imagen referenciada en la base de datos y se extrae su patrón biométrico.

post

Autorizações

AuthorizationstringObrigatório

Bearer authentication header of the form Bearer <token>.

Corpo

Body para la solicitud POST de face

mediaIdstringObrigatório

Un identificador de imagen en la base de datos.

Example: 9c79c818-b81a-4959-b65a-a2b0c8143528

tenantIdstringObrigatório

Un identificador que permite agrupar distintas imágenes o patrones biométricos en un espacio común.

Example: 57fbc814-3f40-402c-9d29-262f99c3b896

descriptionstringObrigatório

Descripción del espécimen (rostro) que se almacena en la base de datos.

Example: It's a description of the person

Respostas

200

Todos los campos de datos del espécimen (rostro) almacenado en la base de datos.

application/json

Campos de datos del espécimen en la base de datos

createAtstringOpcional

Valor de fecha/hora en formato "%Y-%m-%dT%H:%M:%SZ" en el que se creó un espécimen (rostro).

Example: 2024-11-20T15:39:32Z

descriptionstringOpcional

Descripción del espécimen (rostro) que se almacena en la base de datos.

Example: It's a description of the person

facialTemplateRawstringOpcional

Un token extendido que contiene patrones biométricos y metadatos. Se recomienda su almacenamiento en bases de datos por ser persistente. Puede actualizarse automáticamente en caso de cambios en la tecnología de extracción. Está codificado en base64 RFC4648.

Example: QTevT1Lv5jr0rNyzS3u6SAscolMU+bHitq...

idstringOpcional

Un identificador de un espécimen (rostro) en la base de datos.

Example: 6782225b-1793-4b68-a9de-8fdb3628c7e5

mediaIdstringOpcional

Un identificador de imagen en la base de datos.

Example: 9c79c818-b81a-4959-b65a-a2b0c8143528

tenantIdstringOpcional

Un identificador que permite agrupar distintas imágenes o patrones biométricos en un espacio común.

Example: 57fbc814-3f40-402c-9d29-262f99c3b896

updateAtstringOpcional

Valor de fecha/hora en formato "%Y-%m-%dT%H:%M:%SZ" en el que se actualizó un espécimen (rostro).

Example: 2025-03-18T12:54:02Z

400

Llegan parámetros incorrectos en la solicitud.

application/json

500

Se ha producido un error en la llamada al backend.

application/json

post/faces

POST /faces HTTP/1.1
Host: 127.0.0.1:6982/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 149

{
  "mediaId": "9c79c818-b81a-4959-b65a-a2b0c8143528",
  "tenantId": "57fbc814-3f40-402c-9d29-262f99c3b896",
  "description": "It's a description of the person"
}

{
  "createAt": "2024-11-20T15:39:32Z",
  "description": "It's a description of the person",
  "facialTemplateRaw": "QTevT1Lv5jr0rNyzS3u6SAscolMU+bHitq...",
  "id": "6782225b-1793-4b68-a9de-8fdb3628c7e5",
  "mediaId": "9c79c818-b81a-4959-b65a-a2b0c8143528",
  "tenantId": "57fbc814-3f40-402c-9d29-262f99c3b896",
  "updateAt": "2025-03-18T12:54:02Z"
}