> 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/ine/technical_documentation/api_reference/authentication/api-v1-facial-authentication.md).

# /api/v1/facial/authentication

Este endpoint se utiliza para autenticar dos imágenes de fotos.

```json
{"openapi":"3.0.0","info":{"title":"INE-Service Rest API","version":"1.7.0"},"tags":[{"name":"Authentication","description":"Operación protegida de autenticación facial."}],"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":{"AuthenticationBody":{"type":"object","description":"Cuerpo de la solicitud de autenticación","properties":{"idTransaccion":{"$ref":"#/components/schemas/IdTransaction"},"fotoA":{"$ref":"#/components/schemas/Photo"},"fotoB":{"$ref":"#/components/schemas/Photo"}},"required":["idTransaccion","fotoA","fotoB"]},"IdTransaction":{"type":"string","description":"Identificador único asociado a la transacción que se está procesando."},"Photo":{"type":"object","properties":{"tipo":{"$ref":"#/components/schemas/PhotoTypes"},"data":{"$ref":"#/components/schemas/PhotoBuffer"}}},"PhotoTypes":{"type":"number","description":"Tipos de imagen de foto soportados.","enum":["INE               = 0","JPEG              = 1","TEMPLATE_RAW      = 2","BEST_IMAGE_TOKEN  = 3"]},"PhotoBuffer":{"type":"string","description":"Imagen de la foto codificada en base64 RFC4648."},"AuthenticationResponse":{"type":"object","description":"Resultado de la comparación de fotos","properties":{"codigo":{"$ref":"#/components/schemas/ErrorCodes"},"score":{"$ref":"#/components/schemas/Score"},"resultado":{"$ref":"#/components/schemas/Similarity"},"tiempoServicio":{"$ref":"#/components/schemas/ServiceTime"}}},"ErrorCodes":{"type":"number","description":"Códigos de error de la operación.","enum":["OK              = 0","MALFORMED_JSON  = 400","PHOTOA_EMPTY    = 401","PHOTOB_EMPTY    = 402","NO_PHOTOS       = 403","POSE_INVALID    = 404","PHOTOA_INVALID  = 405","PHOTOB_INVALID  = 406"]},"Score":{"type":"integer","minimum":0,"maximum":1,"description":"Puntuación resultante de la comparación."},"Similarity":{"type":"number","minimum":0,"maximum":100,"description":"Similitud resultante de la comparación."},"ServiceTime":{"type":"integer","description":"Tiempo total en milisegundos desde que llega la solicitud hasta que se envía la respuesta."},"BadRequestResult":{"type":"object","description":"Resultado cuando llegan parámetros incorrectos en la solicitud.","properties":{"status":{"type":"number"},"error":{"type":"string"},"message":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}}},"TimeStamp":{"type":"string","description":"Un valor de fecha/hora en formato \"%Y-%m-%dT%H:%M:%SZ\"."},"UnauthorizedResult":{"type":"object","description":"Resultado cuando la solicitud no proporciona un JWT válido.","properties":{"status":{"type":"number"},"error":{"type":"string"},"message":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}}},"ExceptionResult":{"type":"object","description":"Se ha producido un error en la llamada al backend del SDK.","properties":{"status":{"type":"number"},"error":{"type":"string"},"exception":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}}}}},"paths":{"/api/v1/facial/authentication":{"post":{"description":"Este endpoint se utiliza para autenticar dos imágenes de fotos.","tags":["Authentication"],"requestBody":{"description":"Json con la foto de entrada codificada en formato base64 RFC4648","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationBody"}}}},"responses":{"200":{"description":"El resultado de la autenticación.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationResponse"}}}},"400":{"description":"Llegan parámetros incorrectos en la solicitud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResult"}}}},"401":{"description":"Falta el token de autenticación JWT o no es válido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResult"}}}},"500":{"description":"Se ha producido un error en la llamada al backend del SDK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExceptionResult"}}}}}}}}}
```