Obtenir le selfie

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

Disponible uniquement pour les processus ayant exécuté la capture biométrique (tout flux incluant la détection de vivacité ou la vérification d'identité). Non disponible pour les flux de revalidation intelligente (idsmart).

Point de terminaison

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

En-tête	Valeur
Authorization	Bearer <access_token> (voir Authentification)

Paramètres de chemin

Paramètre	Type	Requis	Description
processId	string (UUID)	oui	Identifiant du processus retourné 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 is a base64-encoded image string

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.

400 Bad Request

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

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 selfie n'est pas disponible pour ce processus (ex. : flux de revalidation intelligente).

Codes d'erreur

remarque

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

400 Bad Request

Aucune valeur code ou message spécifique n'est documentée pour ce statut.

401 Unauthorized

Aucune valeur code ou message spécifique n'est documentée pour ce statut.

403 Forbidden

Aucune valeur code ou message spécifique n'est documentée pour ce statut.

404 Not Found

Aucune valeur code ou message spécifique n'est documentée pour ce statut.

Étapes suivantes

• Pour le résultat complet du processus, voir Obtenir le processus.
• Pour le bundle d'audit des preuves, voir Obtenir l'ensemble de preuves.