---
title: "Extraer imagen de la captura"
method: POST
path: "/api/v1/iad/extract"
tags: ["IAD"]
---

# Extraer imagen de la captura

`POST /api/v1/iad/extract`

Extrae y valida los datos de imagen de la captura biométrica.
El nombre del campo de la solicitud multipart debe ser `capture`; el campo heredado `file` no se acepta.

Si el servicio no puede analizar o desencriptar el payload, devuelve HTTP 400.
Los errores del payload de captura se normalizan a `NoneBecauseImageDataError`.
Si la mitigación experimental de ataques de repetición está habilitada en el momento del despliegue, las capturas expiradas se rechazan con
HTTP 400 y el mensaje `Replay attack detected`.
Los fallos de extracción sin clasificar se devuelven como `ErrorFacialImage`.

## Response `200`

Datos de la imagen extraída

- ExtractImageResult
  - `image` string, byte — Imagen extraída codificada en base64.
  - `mimeType` string — Tipo MIME de la imagen extraída.

## Other responses

- `400` — Parámetros incorrectos, error en el payload o error de validación de vigencia de la captura. Errores públicos típicos para este endpoint: - Fallo al analizar el archivo (`NoneBecauseImageDataError`) - Fallo al desencriptar el mensaje (`NoneBecauseImageDataError`) - Ventana de vigencia de repetición superada (`Replay attack detected`)
- `500` — Se ha producido un error en el backend.

---

[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)