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

# 2.0.0

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

## Visão geral

Facephi Finger Service 2.0.0 introduz o contrato público de Facephi para a extração de Impressão Digital e a autenticação 1:1.

Esta versão fornece:

* Endpoints públicos de operações de Impressão Digital baseados no contrato 2.0.0
* Remoção das rotas públicas herdadas 1.x.x
* Validação de solicitações mais rigorosa para as operações de Impressão Digital
* Formatos de imagem suportados para as solicitações de Impressão Digital baseadas em imagem: `wsq`, `bmp`, `png`, `jpg`, `jp2`

## Alterações incompatíveis (Breaking Changes)

* `POST /api/v1/finger/create-template` foi substituído por `POST /api/v1/finger/extract`.
* `POST /api/v1/finger/verify` foi substituído por `POST /api/v1/finger/authenticate`.
* Os payloads das operações de Impressão Digital não são compatíveis com clientes 1.x.x.

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

* Atualize as integrações do cliente para usar `/extract` e `/authenticate`.
* Atualize os payloads de solicitação para os nomes de campo públicos da versão 2.0.0.
* Elimine qualquer dependência de campos herdados ou da disponibilidade de rotas herdadas.

## Implantação

```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 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.