---
title: "Autenticar huellas dactilares (1:1)"
method: POST
path: "/api/v1/finger/authenticate"
tags: ["Finger Operations"]
---

# Autenticar huellas dactilares (1:1)

`POST /api/v1/finger/authenticate`

IMPORTANTE - CAMBIO INCOMPATIBLE (BREAKING CHANGE) (2.0.0)
Este endpoint no es compatible con la versión 1.x.x.
La versión 2.0.0 acepta imágenes/plantillas mediante campos públicos y devuelve
los campos públicos `authStatus` y `similarity`.
Formatos de imagen de entrada admitidos para `image1` e `image2`: wsq, bmp, png, jpg, jp2.

## Request body

- AuthenticateRequest — Petición pública de autenticación 1:1. Se requiere exactamente un origen por lado: - Lado 1: image1 o fingerTemplate1 - Lado 2: image2 o fingerTemplate2 La posición puede indicarse como `position` compartida o mediante `position1` y `position2` específicas de cada lado.
  - `image1` string — Imagen de huella dactilar de referencia (probe), codificada en Base64. Formatos admitidos; wsq, bmp, png, jpg, jp2.
  - `image2` string — Imagen de huella dactilar de galería, codificada en Base64. Formatos admitidos; wsq, bmp, png, jpg, jp2.
  - `fingerTemplate1` string — Plantilla de huella dactilar de referencia (probe), codificada en Base64.
  - `fingerTemplate2` string — Plantilla de huella dactilar de galería, codificada en Base64.
  - `position` 'RightThumb' | 'RightIndex' | 'RightMiddle' | 'RightRing' | 'RightLittle' | 'LeftThumb' | 'LeftIndex' | 'LeftMiddle' | 'LeftRing' | 'LeftLittle' — Posición pública compartida del dedo, usada cuando no se indican posiciones específicas por lado.
  - `position1` 'RightThumb' | 'RightIndex' | 'RightMiddle' | 'RightRing' | 'RightLittle' | 'LeftThumb' | 'LeftIndex' | 'LeftMiddle' | 'LeftRing' | 'LeftLittle' — Sobrescritura opcional de la posición del dedo de referencia (probe).
  - `position2` 'RightThumb' | 'RightIndex' | 'RightMiddle' | 'RightRing' | 'RightLittle' | 'LeftThumb' | 'LeftIndex' | 'LeftMiddle' | 'LeftRing' | 'LeftLittle' — Sobrescritura opcional de la posición del dedo de galería.
  - `options` PublicOptions — Parámetros de ajuste opcionales para las operaciones de extract y authenticate.
    - `dpi` integer
    - `scanType` 'Plain' | 'Rolled' | 'Latent'
    - `includeQuality` boolean
    - `authThreshold` integer — Umbral de autenticación como número entero entre 0 y 100.

## Response `200`

Respuesta pública de autenticación.

- AuthenticateResponse — Respuesta pública de autenticación 1:1.
  - `authStatus` 'Positive' | 'Negative', required
  - `similarity` number, float, required — Puntuación de similitud en el rango 0-100.
  - `sdkDuration` integer, required — Tiempo de ejecución del SDK en milisegundos.
  - `queueDuration` integer, required — Tiempo de espera en cola en milisegundos.

## Other responses

- `400` — Payload inválido o fallo en el procesamiento subyacente.
- `500` — Error inesperado del servicio.

---

[API](https://skmtc.net/facephi/apis/selphid-sdk-rest-api.md) · [All operations](https://skmtc.net/facephi/apis/selphid-sdk-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/facephi/selphid-sdk-rest-api/revisions/acc985032f98/schema)