> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/backend1n/technical_documentation/api_reference/faces/faces-1.md).

# /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.

```json
{"openapi":"3.0.1","info":{"title":"API REST de Backend1n-Service","version":"4.2.0"},"servers":[{"url":"http://127.0.0.1:6982/"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"FaceBody":{"type":"object","description":"Body para la solicitud POST de face","properties":{"mediaId":{"$ref":"#/components/schemas/MediaId"},"tenantId":{"$ref":"#/components/schemas/TenantId"},"description":{"$ref":"#/components/schemas/FaceDescription"}},"required":["mediaId","tenantId","description"]},"MediaId":{"type":"string","description":"Un identificador de imagen en la base de datos."},"TenantId":{"type":"string","description":"Un identificador que permite agrupar distintas imágenes o patrones biométricos en un espacio común."},"FaceDescription":{"type":"string","description":"Descripción del espécimen (rostro) que se almacena en la base de datos."},"FaceResponse":{"type":"object","description":"Campos de datos del espécimen en la base de datos","properties":{"createAt":{"$ref":"#/components/schemas/CreateAt"},"description":{"$ref":"#/components/schemas/FaceDescription"},"facialTemplateRaw":{"$ref":"#/components/schemas/FacialTemplateRaw"},"id":{"$ref":"#/components/schemas/FaceId"},"mediaId":{"$ref":"#/components/schemas/MediaId"},"tenantId":{"$ref":"#/components/schemas/TenantId"},"updateAt":{"$ref":"#/components/schemas/UpdateAt"}}},"CreateAt":{"type":"string","description":"Valor de fecha/hora en formato \"%Y-%m-%dT%H:%M:%SZ\" en el que se creó un espécimen (rostro)."},"FacialTemplateRaw":{"type":"string","description":"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."},"FaceId":{"type":"string","description":"Un identificador de un espécimen (rostro) en la base de datos."},"UpdateAt":{"type":"string","description":"Valor de fecha/hora en formato \"%Y-%m-%dT%H:%M:%SZ\" en el que se actualizó un espécimen (rostro)."},"BadRequestResult":{"type":"object","description":"Resultado cuando llegan parámetros incorrectos en la solicitud.","properties":{"status":{"type":"number"},"error":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}}},"TimeStamp":{"type":"string","description":"Un valor de fecha/hora en formato \"%Y-%m-%dT%H:%M:%SZ\"."},"ExceptionResult":{"type":"object","description":"Se ha producido un error en la llamada a los servicios del backend.","properties":{"status":{"type":"number"},"error":{"type":"string"},"exception":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}}}}},"paths":{"/faces":{"post":{"description":"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.","tags":["Faces"],"requestBody":{"description":"Datos necesarios para añadir un nuevo espécimen (rostro) a la base de datos.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FaceBody"}}}},"responses":{"200":{"description":"Todos los campos de datos del espécimen (rostro) almacenado en la base de datos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FaceResponse"}}}},"400":{"description":"Llegan parámetros incorrectos en la solicitud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResult"}}}},"500":{"description":"Se ha producido un error en la llamada al backend.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExceptionResult"}}}}}}}}}
```