1.0.0

Release date: February 3, 2026

General overview

First major Version of Facephi IAD Service, with standardized API Endpoints, improved Docker Integration, and improved engine management.

This version includes breaking changes in the Endpoint paths. All Endpoints now use the prefix /iad to maintain consistency across the Facephi ecosystem.

What's new

Endpoint standardization (breaking change)

All API Endpoints now use standardized paths with the prefix /iad:

Old Endpoint	New Endpoint
/api/v1/check-capture	/api/v1/iad/check-capture
/api/v1/extract-image	/api/v1/iad/extract-image
/api/v1/extract_data	Removed
/api/v1/version	/api/v1/iad/version
/api/v1/health	/api/v1/iad/health
/api/v1/config	/api/v1/iad/config

Improved Docker Integration

• Automatic detection of the Docker environment

• Self-managed Initialization of the engine inside the container

• Improved process lifecycle management

• Optimized health check times

License-based engine activation

• Automatic engine activation using the License metadata

• Frictionless deployment with embedded License configuration

• Reduction in manual configuration steps

Compatibility improvements

• File system compatibility for GCC 7 was added

• Cross-platform build support was improved

Breaking changes

⚠️ Required action:

1. Update the API Endpoints

All client integrations must update the Endpoint paths to include the prefix /iad.

Before:

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

After:

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

2. Remove references to extract_data

The endpoint /extract_data has been removed. Use /iad/extract-image instead.

Migration guide

Step 1: Update the client code

Replace all endpoint URLs:

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

Step 2: Update monitoring

Update the health check endpoints in the monitoring tools:

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

Step 3: Test the integration

Verify that all API calls work with the new Endpoints before deployment to production.

Deployment

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

Requirements

Component	Requirement
Operating system	Linux x86_64 (Ubuntu 24.04 recommended)
License	Valid Facephi License file (v1.0.0+)
IAD Engine	Compatible engine Version
Docker	For container deployment

Known issues

No issues have been identified in this version.

Support

For migration assistance or Technical Support, contact your Facephi representative.

Documentation

• Installation guide

• API reference

• Changelog