Récupérer le lot de preuves

MarkdownChatGPTClaude

Renvoie le lot de preuves généré pendant la capture biométrique — un ensemble contenant les images capturées, les métadonnées et les artefacts de capture utilisés pour prouver que la détection de vie a été réalisée dans des conditions contrôlées.

Disponible uniquement pour les processus terminés (state = PROCESS_STATE_FINISHED).

Endpoint

Environnement	URL
Production	GET https://api.idcloud.unico.app/client/v1/process/{processId}/evidenceset
Sandbox	GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/evidenceset

Requête

En-têtes

Header	Value
Authorization	Bearer <access_token> (voir Authentification)

Paramètres de chemin

Paramètre	Type	Requis	Description
processId	string (UUID)	oui	Identifiant du processus renvoyé par Créer un processus.

Exemple

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 est un lot PDF encodé en base64

Réponses

200 OK

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

Champ	Type	Description
fileContents	string (base64)	Le lot de preuves, encodé en base64.
contentType	string	Type MIME — généralement application/pdf.

Codes d'erreur

remarque

L'API n'expose pas de valeurs code ou message spécifiques pour cet endpoint.

400 Bad Request

Le paramètre de chemin processId est manquant ou mal formé.

401 Unauthorized

Jeton Bearer manquant, expiré ou invalide. Voir Authentification.

404 Not Found

Processus introuvable, ou le lot de preuves n'est pas encore disponible (processus non terminé).

500 Internal Server Error

Code	Message	Description
99999	Internal failure! Try again later	Lorsqu'il y a une erreur interne.

Prochaines étapes

• Pour le résultat complet du processus, voir Récupérer un processus.
• Pour l'image du selfie capturé, voir Récupérer le selfie.