> 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/autenticar-huellas-dactilares-1-1.md).

# Autenticar huellas dactilares (1:1)

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.

```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":{"AuthenticateRequest":{"type":"object","description":"Petición pública de autenticación 1:1.\nSe requiere exactamente un origen por lado:\n- Lado 1: image1 o fingerTemplate1\n- Lado 2: image2 o fingerTemplate2\nLa posición puede indicarse como `position` compartida o mediante `position1` y `position2` específicas de cada lado.\n","properties":{"image1":{"type":"string","description":"Imagen de huella dactilar de referencia (probe), codificada en Base64. Formatos admitidos; wsq, bmp, png, jpg, jp2."},"image2":{"type":"string","description":"Imagen de huella dactilar de galería, codificada en Base64. Formatos admitidos; wsq, bmp, png, jpg, jp2."},"fingerTemplate1":{"type":"string","description":"Plantilla de huella dactilar de referencia (probe), codificada en Base64."},"fingerTemplate2":{"type":"string","description":"Plantilla de huella dactilar de galería, codificada en Base64."},"position":{"type":"string","description":"Posición pública compartida del dedo, usada cuando no se indican posiciones específicas por lado.","enum":["RightThumb","RightIndex","RightMiddle","RightRing","RightLittle","LeftThumb","LeftIndex","LeftMiddle","LeftRing","LeftLittle"]},"position1":{"type":"string","description":"Sobrescritura opcional de la posición del dedo de referencia (probe).","enum":["RightThumb","RightIndex","RightMiddle","RightRing","RightLittle","LeftThumb","LeftIndex","LeftMiddle","LeftRing","LeftLittle"]},"position2":{"type":"string","description":"Sobrescritura opcional de la posición del dedo de galería.","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}}},"AuthenticateResponse":{"type":"object","description":"Respuesta pública de autenticación 1:1.","required":["authStatus","similarity","sdkDuration","queueDuration"],"properties":{"authStatus":{"type":"string","enum":["Positive","Negative"]},"similarity":{"type":"number","format":"float","description":"Puntuación de similitud en el rango 0-100."},"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."}}},"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/authenticate":{"post":{"summary":"Autenticar huellas dactilares (1:1)","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 acepta imágenes/plantillas mediante campos públicos y devuelve\nlos campos públicos `authStatus` y `similarity`.\nFormatos de imagen de entrada admitidos para `image1` e `image2`: wsq, bmp, png, jpg, jp2.\n","operationId":"authenticate","tags":["Finger Operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticateRequest"}}}},"responses":{"200":{"description":"Respuesta pública de autenticación.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticateResponse"}}}},"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"}}}}}}}}}
```