---
title: "Extraer plantilla de huella dactilar"
method: POST
path: "/api/v1/finger/extract"
tags: ["Finger Operations"]
---

# Extraer plantilla de huella dactilar

`POST /api/v1/finger/extract`

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 utiliza el contrato público (`image`, `position`, `options`) y devuelve
campos públicos (`fingerTemplate`, `quality`, `qualityDetails`, `sdkDuration`, `queueDuration`).
Formatos de imagen de entrada admitidos para `image`: wsq, bmp, png, jpg, jp2.

## Request body

- ExtractRequest
  - `image` string, required — Imagen de huella dactilar codificada en Base64. Formatos admitidos; wsq, bmp, png, jpg, jp2.
  - `position` 'RightThumb' | 'RightIndex' | 'RightMiddle' | 'RightRing' | 'RightLittle' | 'LeftThumb' | 'LeftIndex' | 'LeftMiddle' | 'LeftRing' | 'LeftLittle', required — Nombre público de la posición del dedo.
  - `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 extract.

- ExtractResponse — Respuesta pública de extract.
  - `fingerTemplate` string, required — Plantilla generada, codificada en Base64.
  - `position` 'RightThumb' | 'RightIndex' | 'RightMiddle' | 'RightRing' | 'RightLittle' | 'LeftThumb' | 'LeftIndex' | 'LeftMiddle' | 'LeftRing' | 'LeftLittle', required
  - `scanType` 'Plain' | 'Rolled' | 'Latent', required
  - `quality` integer — Puntuación de calidad global (0-100), cuando está disponible.
  - `qualityDetails` QualityDetails
    - `nfiq2` number, float
    - `nfiq` number, float
    - `score` number, float
  - `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)