Obtener Selfie

MarkdownChatGPTClaude

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.

Disponible para cualquier proceso finalizado que haya ejecutado una captura biométrica, incluidas las jornadas de Revalidación Inteligente (idsmart). No disponible cuando el proceso finalizó sin una captura biométrica (por ejemplo, una autenticación silenciosa), ya que no hay ninguna selfie que devolver.

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.

Códigos de Error

nota

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

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 el proceso finalizó sin una captura biométrica, por lo que no hay ninguna selfie que devolver.

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.