> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/finger/technical_documentation/api_reference/finger-operations/extraer-plantilla-de-huella-dactilar.md).

# Extraer plantilla de huella dactilar

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.

```json
{"openapi":"3.0.1","info":{"title":"Facephi Finger Service REST API","version":"2.1.0"},"tags":[{"name":"Finger Operations","description":"IMPORTANTE - CAMBIO INCOMPATIBLE (BREAKING CHANGE) (2.0.0)\nLos endpoints de esta etiqueta utilizan el nuevo contrato público de payload 2.0.0.\n"}],"servers":[{"url":"http://127.0.0.1:6982/"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"ExtractRequest":{"type":"object","required":["image","position"],"properties":{"image":{"type":"string","description":"Imagen de huella dactilar codificada en Base64. Formatos admitidos; wsq, bmp, png, jpg, jp2."},"position":{"type":"string","description":"Nombre público de la posición del dedo.","enum":["RightThumb","RightIndex","RightMiddle","RightRing","RightLittle","LeftThumb","LeftIndex","LeftMiddle","LeftRing","LeftLittle"]},"options":{"$ref":"#/components/schemas/PublicOptions"}}},"PublicOptions":{"type":"object","description":"Parámetros de ajuste opcionales para las operaciones de extract y authenticate.","properties":{"dpi":{"type":"integer","minimum":250,"maximum":1000,"default":500},"scanType":{"type":"string","enum":["Plain","Rolled","Latent"],"default":"Plain"},"includeQuality":{"type":"boolean","default":true},"authThreshold":{"type":"integer","description":"Umbral de autenticación como número entero entre 0 y 100.","minimum":0,"maximum":100,"default":20}}},"ExtractResponse":{"type":"object","description":"Respuesta pública de extract.","required":["fingerTemplate","position","scanType","sdkDuration","queueDuration"],"properties":{"fingerTemplate":{"type":"string","description":"Plantilla generada, codificada en Base64."},"position":{"type":"string","enum":["RightThumb","RightIndex","RightMiddle","RightRing","RightLittle","LeftThumb","LeftIndex","LeftMiddle","LeftRing","LeftLittle"]},"scanType":{"type":"string","enum":["Plain","Rolled","Latent"]},"quality":{"type":"integer","description":"Puntuación de calidad global (0-100), cuando está disponible."},"qualityDetails":{"$ref":"#/components/schemas/QualityDetails"},"sdkDuration":{"type":"integer","format":"int64","description":"Tiempo de ejecución del SDK en milisegundos."},"queueDuration":{"type":"integer","format":"int64","description":"Tiempo de espera en cola en milisegundos."}}},"QualityDetails":{"type":"object","properties":{"nfiq2":{"type":"number","format":"float"},"nfiq":{"type":"number","format":"float"},"score":{"type":"number","format":"float"}}},"BadRequestResult":{"type":"object","properties":{"status":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}},"required":["status","error","message","timeStamp"]},"TimeStamp":{"type":"string","description":"Fecha y hora en formato ISO-8601."},"ExceptionResult":{"type":"object","properties":{"status":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"},"exception":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}},"required":["status","error","message","exception","timeStamp"]}}},"paths":{"/api/v1/finger/extract":{"post":{"summary":"Extraer plantilla de huella dactilar","description":"IMPORTANTE - CAMBIO INCOMPATIBLE (BREAKING CHANGE) (2.0.0)\nEste endpoint no es compatible con la versión 1.x.x.\nLa versión 2.0.0 utiliza el contrato público (`image`, `position`, `options`) y devuelve\ncampos públicos (`fingerTemplate`, `quality`, `qualityDetails`, `sdkDuration`, `queueDuration`).\nFormatos de imagen de entrada admitidos para `image`: wsq, bmp, png, jpg, jp2.\n","operationId":"extract","tags":["Finger Operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractRequest"}}}},"responses":{"200":{"description":"Respuesta pública de extract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractResponse"}}}},"400":{"description":"Payload inválido o fallo en el procesamiento subyacente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResult"}}}},"500":{"description":"Error inesperado del servicio.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExceptionResult"}}}}}}}}}
```