2.0.0

Data de lançamento: 8 de junho de 2026

Visão geral

Facephi Finger Service 2.0.0 apresenta o contrato público da 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

• Eliminação das rotas públicas herdadas 1.x.x

• Validação de requisições mais rigorosa para as operações de Impressão Digital

• Formatos de imagem aceitos para as requisições de Impressão Digital baseadas em imagem: wsq, bmp, png, jpg, jp2

Mudanças 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	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 de 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

• Atualize as integrações do cliente para usar /extract e /authenticate.

• Atualize os payloads de requisiçã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

docker pull facephicorp.jfrog.io/docker-core-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-core-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 em memória e não são persistidas automaticamente.

• Alguns valores de configuração exigem reinício para serem aplicados completamente (port, number_of_threads).

Documentação

• Guia de instalação

• Especificações técnicas

• Registro de alterações

Suporte

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