Release Notes - Version 2.1.0

Release Date: June 11, 2026

Overview

Facephi Finger Service 2.1.0 adds the operational metrics endpoint used to report fingerprint usage counters.

This release provides:

• Public fingerprint extraction and 1:1 authentication endpoints on the Facephi contract
• Usage counter reporting through GET /api/v1/finger/metrics
• Explicit documentation of supported fingerprint image formats for image-based requests: wsq, bmp, png, jpg, jp2

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/metrics	GET	Report fingerprint usage counters
/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

• Clients that need operational visibility can start consuming the /metrics endpoint.
• Continue to rely on the documented public fields only; internal processing details remain abstracted.

Deployment

docker pull facephicorp.jfrog.io/docker-core-pro-fphi/facephi-finger-service:2.1.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.1.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

• Installation Guide
• Technical Specifications
• Changelog

Support

For technical support, contact your Facephi representative.