Obtener conjunto de evidencias

Devuelve el paquete de evidencias generado durante la captura biométrica — un paquete que contiene las imágenes capturadas, los metadatos y los artefactos de captura utilizados para demostrar que la detección de vida fue realizada bajo condiciones controladas.

Solo disponible para procesos completados (state = PROCESS_STATE_FINISHED).

Endpoint

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

Solicitud

Encabezados

Encabezado	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/evidenceset \
  -H "Authorization: Bearer $TOKEN"

Node.js

import fetch from 'node-fetch';

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

Respuestas

200 OK

{
  "fileContents": "JVBERi0xLjMNCi...",
  "contentType": "application/pdf"
}

Campo	Tipo	Descripción
fileContents	string (base64)	El paquete de evidencias, codificado en base64.
contentType	string	Tipo MIME — normalmente application/pdf.

400 Bad Request

El parámetro de ruta processId está ausente o tiene un formato incorrecto. Consulte Códigos de error a continuación.

401 Unauthorized

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

404 Not Found

Proceso no encontrado, o el conjunto de evidencias aún no está disponible (el proceso no ha finalizado).

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 específicos de code o message documentados para este estado.

401 Unauthorized

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

404 Not Found

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

500 Internal Server Error

Código	Mensaje	Descripción
99999	Internal failure! Try again later	Cuando ocurre un error interno.

Próximos pasos

• Para el resultado completo del proceso, consulte Obtener proceso.
• Para la imagen del selfie capturado, consulte Obtener selfie.