> 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

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

Esta versão fornece:

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

## Endpoints incluídos

| Endpoint                      | Método   | Propósito                                                            |
| ----------------------------- | -------- | -------------------------------------------------------------------- |
| `/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 de Impressão Digital                      |
| `/api/v1/finger/metrics`      | GET      | Informa os contadores de uso de Impressão Digital                    |
| `/api/v1/finger/version`      | GET      | Versão do serviço e estado 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 confiando apenas nos campos públicos documentados; os detalhes internos de 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 de operações de Impressão Digital só estão disponíveis quando o serviço é executado no papel `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 completamente (`port`, `number_of_threads`).

## Documentação

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

## Suporte

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