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

# 2.1.0

**Data de lançamento:** 11 de junho de 2026

## Visão geral

O Facephi Finger Service 2.1.0 adiciona o endpoint operacional de métricas usado para informar os contadores de uso da Impressão Digital.

Esta versão oferece:

* Endpoints públicos de extração de Impressão Digital e autenticação 1:1 com base no contrato da Facephi
* Informe os contadores de uso por meio de `GET /api/v1/finger/metrics`
* Documentação explícita dos formatos de imagem de Impressão Digital aceitos para solicitações baseadas em imagem: `wsq`, `bmp`, `png`, `jpg`, `jp2`

## Endpoints incluídos

| Endpoint                      | Método   | Finalidade                                                           |
| ----------------------------- | -------- | -------------------------------------------------------------------- |
| `/api/v1/finger/extract`      | POST     | Gera um template de Impressão Digital a partir de um payload público |
| `/api/v1/finger/authenticate` | POST     | Executa a autenticação 1:1 por Impressão Digital                     |
| `/api/v1/finger/metrics`      | GET      | Informa os contadores de uso da Impressão Digital                    |
| `/api/v1/finger/version`      | GET      | Versão do serviço e status da Licença                                |
| `/api/v1/finger/health`       | GET      | Saúde e disponibilidade do serviço                                   |
| `/api/v1/finger/config`       | GET/POST | Obtém ou atualiza a configuração em tempo de execução                |

## Notas de migração

* Os clientes que precisarem de visibilidade operacional podem começar a consumir o endpoint `/metrics`.
* Continue usando apenas os campos públicos documentados; os detalhes internos do processamento permanecem abstraídos.

## Implantação

```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 operacional | Linux x86\_64                     |
| Licença             | Arquivo de Licença Facephi válido |
| Docker              | Recomendado para a implantação    |

## Limitações conhecidas

* Os endpoints das operações de Impressão Digital só estão disponíveis quando o serviço está sendo executado na função `master`.
* As atualizações dinâmicas de configuração são aplicadas na memória e não são persistidas automaticamente.
* Alguns valores de configuração exigem reinicialização para serem aplicados integralmente (`port`, `number_of_threads`).

## Documentação

* [Guia de instalação](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/finger/installation/installation_instructions.md)
* [Especificações técnicas](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/finger/technical_documentation/technical_specifications.md)
* [Registro de alterações](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/finger/changelog.md)

## Suporte

Para obter Suporte Técnico, entre em contato com seu representante da Facephi.
