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

# 1.0.0

**Fecha de lanzamiento:** 3 de febrero de 2026

## Resumen general

Primera versión mayor de **Facephi IAD Service**, con endpoints de API estandarizados, integración con Docker mejorada y una gestión del engine mejorada.

Esta versión incluye cambios incompatibles en las rutas de los endpoints. Todos los endpoints ahora usan el prefijo `/iad` para mantener la coherencia en todo el ecosistema Facephi.

## Novedades

### Estandarización de endpoints (cambio incompatible)

Todos los endpoints de la API ahora usan rutas estandarizadas con el prefijo `/iad`:

| Endpoint antiguo        | Endpoint nuevo              |
| ----------------------- | --------------------------- |
| `/api/v1/check-capture` | `/api/v1/iad/check-capture` |
| `/api/v1/extract-image` | `/api/v1/iad/extract-image` |
| `/api/v1/extract_data`  | *Eliminado*                 |
| `/api/v1/version`       | `/api/v1/iad/version`       |
| `/api/v1/health`        | `/api/v1/iad/health`        |
| `/api/v1/config`        | `/api/v1/iad/config`        |

### Integración con Docker mejorada

* Detección automática del entorno Docker
* Inicialización autogestionada del engine dentro del contenedor
* Gestión mejorada del ciclo de vida de los procesos
* Tiempos de comprobación de estado optimizados

### Activación del engine basada en licencia

* Activación automática del engine usando los metadatos de la licencia
* Despliegue sin fricciones con configuración de licencia incrustada
* Reducción de los pasos de configuración manual

### Mejoras de compatibilidad

* Se añadió compatibilidad de sistema de archivos para GCC 7
* Se mejoró el soporte de compilación multiplataforma

## Cambios incompatibles

⚠️ **Acción requerida:**

### 1. Actualizar los endpoints de la API

Todas las integraciones cliente deben actualizar las rutas de los endpoints para incluir el prefijo `/iad`.

**Antes:**

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

**Después:**

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

### 2. Eliminar las referencias a `extract_data`

El endpoint `/extract_data` se ha eliminado. Usa `/iad/extract-image` en su lugar.

## Guía de migración

### Paso 1: Actualizar el código del cliente

Reemplaza todas las URLs de los endpoints:

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

### Paso 2: Actualizar la monitorización

Actualiza los endpoints de comprobación de estado en las herramientas de monitorización:

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

### Paso 3: Probar la integración

Verifica que todas las llamadas a la API funcionan con los nuevos endpoints antes del despliegue en producción.

## Despliegue

```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 operativo | Linux x86\_64 (se recomienda Ubuntu 24.04)      |
| Licencia          | Archivo de licencia válido de Facephi (v1.0.0+) |
| IAD Engine        | Versión de engine compatible                    |
| Docker            | Para el despliegue en contenedores              |

## Problemas conocidos

No se han identificado problemas en esta versión.

## Soporte

Para asistencia en la migración o soporte técnico, contacta con tu representante de Facephi.

## Documentación

* [Guía de instalación](/sdks/backend-sdk/iad/installation/installation_instructions.md)
* [Referencia de la API](/sdks/backend-sdk/iad/technical_documentation/api_reference.md)
* [Registro de cambios](/sdks/backend-sdk/iad/changelog.md)
