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
| Encabezado | Valor |
|---|---|
Authorization | Bearer <access_token> (ver Autenticación) |
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
processId | string (UUID) | sí | Identificador del proceso devuelto por Crear Proceso. |
Ejemplo
- cURL
- Node.js
curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/evidenceset \
-H "Authorization: Bearer $TOKEN" \
| jq -r .fileContents | base64 --decode > evidence-set.pdf
import { writeFile } from 'node:fs/promises';
async function getEvidenceSet(processId) {
const response = await fetch(
`https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
{ headers: { Authorization: `Bearer ${accessToken}` } }
);
if (!response.ok) throw new Error(`Get Evidence Set failed with ${response.status}`);
const { fileContents } = await response.json();
// fileContents es el archivo PDF, codificado en base64
return Buffer.from(fileContents, 'base64');
}
// Guardar el PDF en disco
await writeFile(`evidence-set-${processId}.pdf`, await getEvidenceSet(processId));
// O enviarlo al navegador (Express)
app.get('/processes/:id/evidence-set', async (req, res) => {
const pdf = await getEvidenceSet(req.params.id);
res
.type('application/pdf') // no reenvíes contentType: la API devuelve "x-pdf"
.set('Content-Disposition', 'inline; filename="evidence-set.pdf"')
.send(pdf);
});
Respuestas
{
"fileContents": "JVBERi0xLjMNCi...",
"contentType": "x-pdf"
}
| Campo | Tipo | Descripción |
|---|---|---|
fileContents | string (base64) | El PDF del conjunto de evidencias, codificado en base64. |
contentType | string | Actualmente devuelve x-pdf. |
x-pdf no es un tipo MIME válido, y los navegadores no lo reconocen. No reenvíes contentType al navegador. Decodifica fileContents desde base64 y sirve los bytes como application/pdf, como en el ejemplo de Node.js anterior.
Códigos de Error
La API no expone valores específicos de code o message para este endpoint.
- 400 Bad Request
- 401 Unauthorized
- 404 Not Found
- 500 Internal Server Error
El parámetro de ruta processId está ausente o tiene un formato incorrecto.
Token Bearer ausente, expirado o inválido. Ver Autenticación.
Proceso no encontrado, o el conjunto de evidencias aún no está disponible (el proceso no ha finalizado).
| 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.