Skip to content

Release Notes — Version 1.0.0

Release Date: February 3, 2026

Overview

First major release of Facephi IAD Service with standardized API endpoints, enhanced Docker integration, and improved engine management.

This release includes breaking changes to endpoint paths. All endpoints now use the /iad prefix for consistency across the Facephi ecosystem.

What's New

Endpoint Standardization (Breaking Change)

All API endpoints now use standardized paths with /iad prefix:

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

Enhanced Docker Integration

  • Automatic detection of Docker environment
  • Self-managed engine initialization within container
  • Improved process lifecycle management
  • Optimized health check timing

License-Based Engine Activation

  • Automatic engine activation using license metadata
  • Seamless deployment with embedded license configuration
  • Reduced manual configuration steps

Compatibility Improvements

  • Added filesystem compatibility for GCC 7
  • Improved cross-platform compilation support

Breaking Changes

⚠️ Action Required:

1. Update API Endpoints

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

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 extract_data References

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

Migration Guide

Step 1: Update 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 health check endpoints in monitoring tools:

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

Step 3: Test Integration

Verify all API calls work with new endpoints before production deployment.

Deployment

docker pull facephicorp.jfrog.io/docker-core-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-core-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 containerized deployment

Known Issues

None identified in this release.

Support

For migration assistance or technical support, contact your Facephi representative.

Documentation