1.0.0

Data de lançamento: 3 de fevereiro de 2026

Resumo geral

Primeira versão principal de Facephi IAD Service, com endpoints de API padronizados, integração com Docker aprimorada e uma gestão do engine aprimorada.

Esta versão inclui alterações incompatíveis nas rotas dos endpoints. Todos os endpoints agora usam o prefixo /iad para manter a coerência em todo o ecossistema Facephi.

Novidades

Padronização de endpoints (alteração incompatível)

Todos os endpoints da API agora usam rotas padronizadas com o prefixo /iad:

Endpoint antigo	Endpoint novo
/api/v1/check-capture	/api/v1/iad/check-capture
/api/v1/extract-image	/api/v1/iad/extract-image
/api/v1/extract_data	Removido
/api/v1/version	/api/v1/iad/version
/api/v1/health	/api/v1/iad/health
/api/v1/config	/api/v1/iad/config

Integração com Docker aprimorada

• Detecção automática do ambiente Docker

• Inicialização autogerenciada do engine dentro do contêiner

• Gerenciamento aprimorado do ciclo de vida dos processos

• Tempos de verificação de status otimizados

Ativação do engine baseada em licença

• Ativação automática do engine usando os metadados da licença

• Implantação sem atritos com configuração de licença incorporada

• Redução das etapas de configuração manual

Melhorias de compatibilidade

• Foi adicionada compatibilidade de sistema de arquivos para GCC 7

• Foi aprimorado o suporte de compilação multiplataforma

Alterações incompatíveis

⚠️ Ação necessária:

1. Atualizar os endpoints da API

Todas as integrações do cliente devem atualizar as rotas dos endpoints para incluir o prefixo /iad.

Antes:

curl -X POST http://localhost:6982/api/v1/check-capture

Depois:

curl -X POST http://localhost:6982/api/v1/iad/check-capture

2. Remover as referências a extract_data

O endpoint /extract_data foi removido. Use /iad/extract-image em seu lugar.

Guia de migração

Passo 1: Atualizar o código do cliente

Substitua todas as URLs dos endpoints:

- const url = 'http://localhost:6982/api/v1/check-capture';
+ const url = 'http://localhost:6982/api/v1/iad/check-capture';

Passo 2: Atualizar o monitoramento

Atualize os endpoints de verificação de status nas ferramentas de monitoramento:

- GET /api/v1/health
+ GET /api/v1/iad/health

Passo 3: Testar a integração

Verifique se todas as chamadas à API funcionam com os novos endpoints antes da implantação em produção.

Implantação

docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:1.0.0

docker run -d \
  -p 6982:6982 \
  -v /path/to/license:/app/license \
  -v /path/to/config:/app/config \
  --name iad-service \
  facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:1.0.0

Requisitos

Componente	Requisito
Sistema operacional	Linux x86_64 (recomendado Ubuntu 24.04)
Licença	Arquivo de licença válido da Facephi (v1.0.0+)
IAD Engine	Versão de engine compatível
Docker	Para implantação em contêineres

Problemas conhecidos

Não foram identificados problemas nesta versão.

Suporte

Para assistência na migração ou suporte técnico, entre em contato com seu representante da Facephi.

Documentação

• Guia de instalação

• Referência da API

• Registro de alterações