> 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/sdks/backend-sdk/finger/release_notes/2.1.0_release_notes.md).

# 2.1.0

**Fecha de lanzamiento:** 11 de junio de 2026

## Descripción general

Facephi Finger Service 2.1.0 añade el endpoint operativo de métricas utilizado para informar de los contadores de uso de huella dactilar.

Esta versión proporciona:

* Endpoints públicos de extracción de huella dactilar y autenticación 1:1 sobre el contrato de Facephi
* Informe de contadores de uso mediante `GET /api/v1/finger/metrics`
* Documentación explícita de los formatos de imagen de huella dactilar admitidos para peticiones basadas en imagen: `wsq`, `bmp`, `png`, `jpg`, `jp2`

## Endpoints incluidos

| Endpoint                      | Método   | Propósito                                                              |
| ----------------------------- | -------- | ---------------------------------------------------------------------- |
| `/api/v1/finger/extract`      | POST     | Genera una plantilla de huella dactilar a partir de un payload público |
| `/api/v1/finger/authenticate` | POST     | Ejecuta la autenticación 1:1 de huella dactilar                        |
| `/api/v1/finger/metrics`      | GET      | Informa de los contadores de uso de huella dactilar                    |
| `/api/v1/finger/version`      | GET      | Versión del servicio y estado de la licencia                           |
| `/api/v1/finger/health`       | GET      | Salud y disponibilidad del servicio                                    |
| `/api/v1/finger/config`       | GET/POST | Obtiene o actualiza la configuración en tiempo de ejecución            |

## Notas de migración

* Los clientes que necesiten visibilidad operativa pueden empezar a consumir el endpoint `/metrics`.
* Sigue apoyándote únicamente en los campos públicos documentados; los detalles internos de procesamiento permanecen abstraídos.

## Despliegue

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-finger-service:2.1.0

docker run -d \
  -p 6982:6982 \
  -v /path/to/license:/app/license \
  -v /path/to/config:/app/config \
  --name finger-service \
  facephicorp.jfrog.io/docker-pro-fphi/facephi-finger-service:2.1.0
```

## Requisitos

| Componente        | Requisito                          |
| ----------------- | ---------------------------------- |
| Sistema operativo | Linux x86\_64                      |
| Licencia          | Archivo de licencia Facephi válido |
| Docker            | Recomendado para el despliegue     |

## Limitaciones conocidas

* Los endpoints de operaciones de huella dactilar solo están disponibles cuando el servicio se ejecuta en el rol `master`.
* Las actualizaciones dinámicas de configuración se aplican en memoria y no se persisten automáticamente.
* Algunos valores de configuración requieren reinicio para aplicarse completamente (`port`, `number_of_threads`).

## Documentación

* [Guía de instalación](/sdks/backend-sdk/finger/installation/installation_instructions.md)
* [Especificaciones técnicas](/sdks/backend-sdk/finger/technical_documentation/technical_specifications.md)
* [Registro de cambios](/sdks/backend-sdk/finger/changelog.md)

## Soporte

Para soporte técnico, contacta con tu representante de Facephi.