Obtenir le selfie

MarkdownChatGPTClaude

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 pour tout processus terminé ayant exécuté 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 alors aucun selfie à retourner.

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.

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 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 processus terminé sans capture biométrique : il n'y a donc aucun selfie à retourner.

É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.