Skip to content

Release Notes - Version 2.0.0

Release Date: June 8, 2026

Overview

Facephi Finger Service 2.0.0 introduces the public Facephi contract for fingerprint extraction and 1:1 authentication.

This release provides:

  • Public fingerprint operation endpoints based on the 2.0.0 contract
  • Removal of legacy 1.x.x public routes
  • Stronger request validation for fingerprint operations
  • Supported image formats for image-based fingerprint requests: wsq, bmp, png, jpg, jp2

Breaking Changes

  • POST /api/v1/finger/create-template has been replaced by POST /api/v1/finger/extract.
  • POST /api/v1/finger/verify has been replaced by POST /api/v1/finger/authenticate.
  • Fingerprint operation payloads are not backward compatible with 1.x.x clients.

Included Endpoints

Endpoint Method Purpose
/api/v1/finger/extract POST Generate a fingerprint template from a public payload
/api/v1/finger/authenticate POST Execute 1:1 fingerprint authentication
/api/v1/finger/version GET Service version and license status
/api/v1/finger/health GET Service health and readiness
/api/v1/finger/config GET/POST Retrieve or update runtime configuration

Migration Notes

  • Update client integrations to use /extract and /authenticate.
  • Update request payloads to the 2.0.0 public field names.
  • Remove any dependency on legacy fields or legacy route availability.

Deployment

docker pull facephicorp.jfrog.io/docker-core-pro-fphi/facephi-finger-service:2.0.0

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

Requirements

Component Requirement
Operating System Linux x86_64
License Valid Facephi license file
Docker Recommended for deployment

Known Limitations

  • Fingerprint operation endpoints are available only when the service runs in master role.
  • Dynamic configuration updates are applied in memory and are not persisted automatically.
  • Some configuration values require restart to be fully applied (port, number_of_threads).

Documentation

Support

For technical support, contact your Facephi representative.