> 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.0.0_release_notes.md).

# 2.0.0

**Fecha de lanzamiento:** 8 de junio de 2026

## Descripción general

Facephi Finger Service 2.0.0 introduce el contrato público de Facephi para la extracción de huella dactilar y la autenticación 1:1.

Esta versión proporciona:

* Endpoints públicos de operaciones de huella dactilar basados en el contrato 2.0.0
* Eliminación de las rutas públicas heredadas 1.x.x
* Validación de peticiones más estricta para las operaciones de huella dactilar
* Formatos de imagen admitidos para las peticiones de huella dactilar basadas en imagen: `wsq`, `bmp`, `png`, `jpg`, `jp2`

## Cambios incompatibles (Breaking Changes)

* `POST /api/v1/finger/create-template` ha sido reemplazado por `POST /api/v1/finger/extract`.
* `POST /api/v1/finger/verify` ha sido reemplazado por `POST /api/v1/finger/authenticate`.
* Los payloads de operaciones de huella dactilar no son compatibles con clientes 1.x.x.

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

* Actualiza las integraciones cliente para usar `/extract` y `/authenticate`.
* Actualiza los payloads de petición a los nombres de campo públicos de la versión 2.0.0.
* Elimina cualquier dependencia de campos heredados o de la disponibilidad de rutas heredadas.

## Despliegue

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-finger-service:2.0.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.0.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.