Récupérer le lot de preuves
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
| Header | Value |
|---|---|
Authorization | Bearer <access_token> (voir Authentification) |
| Paramètre | Type | Requis | Description |
|---|---|---|---|
processId | string (UUID) | oui | Identifiant du processus renvoyé par Créer un processus. |
Exemple
- 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 est le fichier PDF, encodé en base64
return Buffer.from(fileContents, 'base64');
}
// Enregistrer le PDF sur le disque
await writeFile(`evidence-set-${processId}.pdf`, await getEvidenceSet(processId));
// Ou l'envoyer au navigateur (Express)
app.get('/processes/:id/evidence-set', async (req, res) => {
const pdf = await getEvidenceSet(req.params.id);
res
.type('application/pdf') // ne transmettez pas contentType : l'API renvoie "x-pdf"
.set('Content-Disposition', 'inline; filename="evidence-set.pdf"')
.send(pdf);
});
Réponses
{
"fileContents": "JVBERi0xLjMNCi...",
"contentType": "x-pdf"
}
| Champ | Type | Description |
|---|---|---|
fileContents | string (base64) | Le PDF du lot de preuves, encodé en base64. |
contentType | string | Renvoie actuellement x-pdf. |
x-pdf n'est pas un type MIME valide, et les navigateurs ne le reconnaissent pas. Ne transmettez pas contentType au navigateur. Décodez fileContents depuis base64 et servez les octets en tant que application/pdf, comme dans l'exemple Node.js ci-dessus.
Codes d'erreur
L'API n'expose pas de valeurs code ou message spécifiques pour cet endpoint.
- 400 Bad Request
- 401 Unauthorized
- 404 Not Found
- 500 Internal Server Error
Le paramètre de chemin processId est manquant ou mal formé.
Jeton Bearer manquant, expiré ou invalide. Voir Authentification.
Processus introuvable, ou le lot de preuves n'est pas encore disponible (processus non terminé).
| 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.