Devuelve la foto del DNI o la selfie de un firmante en formato JPEG binario.

🪪 Descargar Foto del Firmante

Las fotos de los firmantes no tienen URL pública: se descargan desde este endpoint, autenticado con tu x-api-key.

Endpoint: /api/v2/signers/{id_custom}/photo/{type}
Método: GET

Parámetros

• id_custom (string, requerido) — El identificador del firmante (lo recibís en la respuesta de Solicitar Documento). Debe pertenecer a tu cuenta o a tu equipo.
• type (string, requerido) — dni o selfie.

Headers

x-api-key: your-api-key-here

Ejemplo (curl)

curl -H "x-api-key: REEMPLAZAR_POR_TU_API_KEY" \
  "https://api.wapifirma.com/api/v2/signers/F5384BECE0574D809CC129F90C90253B/photo/selfie" \
  -o selfie.jpeg

Respuestas

• 200 OK: Devuelve la imagen JPEG binaria.
• 400 Bad Request: type no es dni ni selfie.

{ "error": "Tipo de foto inválido" }

• 404 Not Found: El id_custom no existe o no pertenece a tu cuenta/equipo.

{ "error": "No se encontró el firmante" }

• 404 Not Found: El firmante existe pero la foto no está disponible (por ejemplo, el flujo no pedía fotos o el firmante todavía no las subió).

{ "error": "No se encontró el archivo" }

• 500 Internal Server Error:

{ "error": "Error al obtener la imagen" }