> 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/iad/release_notes/1.0.0_release_notes.md).

# 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:**

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

**Depois:**

```bash
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:

```diff
- 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:

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

```bash
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](/docs.facephi-pt-br/sdks/backend-sdk/iad/installation/installation_instructions.md)
* [Referência da API](/docs.facephi-pt-br/sdks/backend-sdk/iad/technical_documentation/api_reference.md)
* [Registro de alterações](/docs.facephi-pt-br/sdks/backend-sdk/iad/changelog.md)