Récupérer le selfie

MarkdownChatGPTClaude

Renvoie le selfie biométrique capturé par l'utilisateur pendant le parcours hébergé par Unico. L'image est renvoyée sous forme de chaîne encodée en base64, avec un filigrane appliqué.

Disponible pour tout processus terminé ayant effectué une capture biométrique, y compris les parcours de Revalidation intelligente (idsmart). Non disponible lorsque le processus s'est terminé sans capture biométrique (une authentification silencieuse, par exemple), car il n'y a pas de selfie à renvoyer.

Endpoint

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

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/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 est une chaîne d'image encodée en base64

Réponses

200 OK

{
  "fileContents": "/9j/4AAQSkZJR...",
  "contentType": "image/jpeg"
}

Champ	Type	Description
fileContents	string (base64)	Le selfie capturé, encodé en base64. Contient un filigrane.
contentType	string	Type MIME de l'image — image/jpeg ou image/png.

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.

403 Forbidden

Permissions insuffisantes pour accéder au selfie de ce processus.

404 Not Found

Processus introuvable, ou le processus s'est terminé sans capture biométrique, il n'y a donc pas de selfie à renvoyer.

Prochaines étapes

• Pour le résultat complet du processus, voir Récupérer un processus.
• Pour le lot de preuves d'audit, voir Récupérer le lot de preuves.