Extract image from the capture

Extracts and validates the image data from the biometric capture. The multipart request field name must be capture; the legacy file field is not accepted.

If the service cannot parse or decrypt the payload, it returns HTTP 400. Capture payload errors are normalized to NoneBecauseImageDataError. If the experimental replay attack mitigation is enabled at deployment time, expired captures are rejected with HTTP 400 and the message Replay attack detected. Unclassified extraction failures are returned as ErrorFacialImage.

post

Corpo

capturestring · binaryObrigatório

Binary data buffer, typically biometric capture data (images, video frames, etc.).

Respostas

200

Extracted image data

application/json

imagestring · byteOpcional

Extracted image encoded in base64.

mimeTypestringOpcional

MIME type of the extracted image.

Example: image/jpeg

400

Incorrect parameters, payload error or capture validity validation error.

Typical public errors for this endpoint:

• Failed to parse the file (NoneBecauseImageDataError)
• Failed to decrypt the message (NoneBecauseImageDataError)
• Replay validity window exceeded (Replay attack detected)

application/json

500

An error occurred in the backend.

application/json

post/api/v1/iad/extract

POST /api/v1/iad/extract HTTP/1.1
Host: 127.0.0.1:6982/
Content-Type: multipart/form-data
Accept: */*
Content-Length: 20

{
  "capture": "binary"
}

{
  "image": "Ynl0ZXM=",
  "mimeType": "image/jpeg"
}