/faces

Recupera todos los especímenes (rostros) de la base de datos que coinciden con el tenantId. Si se omite, se devolverán todos los elementos.

get

Autorizações

BearerAuthApiKeyAuth

AuthorizationstringObrigatório

Bearer authentication header of the form Bearer <token>.

Parâmetros de consulta

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

Respostas

200

Todos los especímenes (rostros) almacenados en la base de datos con el mismo tenantId.

application/json

Campos de datos de varios especímenes 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

get/faces

HTTPcURLJavaScriptPython

GET /faces?tenantId=57fbc814-3f40-402c-9d29-262f99c3b896 HTTP/1.1
Host: 127.0.0.1:6982/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "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"
  }
]