Obtener Selfie

Devuelve la selfie biométrica capturada por el usuario durante la jornada alojada por Unico. La imagen se devuelve como una cadena codificada en base64 con una marca de agua aplicada.

Solo disponible para procesos que ejecutaron captura biométrica (cualquier flujo que incluya Liveness o Verificación de Identidad). No disponible para flujos de Smart Revalidation (idsmart).

Endpoint

Entorno	URL
Producción	GET https://api.idcloud.unico.app/client/v1/process/{processId}/selfie
Sandbox	GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/selfie

Solicitud

Cabeceras

Cabecera	Valor
Authorization	Bearer <access_token> (ver Autenticación)

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
processId	string (UUID)	sí	Identificador del proceso devuelto por Crear Proceso.

Ejemplo

cURL

curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/selfie \
  -H "Authorization: Bearer $TOKEN"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.idcloud.unico.app/client/v1/process/${processId}/selfie`,
  { headers: { Authorization: `Bearer ${accessToken}` } }
);
const { fileContents, contentType } = await res.json();
// fileContents is a base64-encoded image string

Respuestas

200 OK

{
  "fileContents": "/9j/4AAQSkZJR...",
  "contentType": "image/jpeg"
}

Campo	Tipo	Descripción
fileContents	string (base64)	La selfie capturada, codificada en base64. Contiene una marca de agua.
contentType	string	Tipo MIME de la imagen — image/jpeg o image/png.

400 Bad Request

El parámetro de ruta processId está ausente o tiene un formato incorrecto.

401 Unauthorized

Token Bearer ausente, expirado o inválido. Ver Autenticación.

403 Forbidden

Permisos insuficientes para acceder a la selfie de este proceso.

404 Not Found

Proceso no encontrado, o la selfie no está disponible para este proceso (por ejemplo, flujo de Smart Revalidation).

Códigos de Error

nota

La API no expone valores específicos de code o message para este endpoint.

400 Bad Request

No hay valores de code o message documentados para este estado.

401 Unauthorized

No hay valores de code o message documentados para este estado.

403 Forbidden

No hay valores de code o message documentados para este estado.

404 Not Found

No hay valores de code o message documentados para este estado.

Próximos pasos

• Para el resultado completo del proceso, consulte Obtener Proceso.
• Para el paquete de auditoría de evidencias, consulte Obtener Conjunto de Evidencias.