Get SelfieGET

Récupérez le selfie capturé lors d'un processus Human Token.

Markdown

Renvoie le selfie biométrique capturé par l'utilisateur lors d'un processus Human Token. L'image est renvoyée sous forme de chaîne encodée en base64.

Disponible pour tout processus terminé ayant effectué une capture biométrique — les cinq flux Human Token (api+humantoken, api+liveness+humantoken, api+liveness+humantoken+revalidation, humantoken, humantoken+revalidation). Non disponible lorsque le processus s'est terminé sans capture biométrique, car il n'y a pas de selfie à renvoyer.

avertissement

Le selfie est disponible pendant 24 heures après la fin du processus. Après cela, l'image est définitivement supprimée et ce endpoint renvoie 404.

Endpoint

Environnement	URL
Production	GET https://humantoken.unico.app/client/v1/process/{processId}/selfie

Requête

En-têtes

En-tête	Valeur
x-unico-accesskey	<your_access_key> (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://humantoken.unico.app/client/v1/process/$PROCESS_ID/selfie \
  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://humantoken.unico.app/client/v1/process/${processId}/selfie`,
  { headers: { 'x-unico-accesskey': process.env.UNICO_ACCESS_KEY } }
);
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.
contentType	string	Type MIME de l'image — image/jpeg ou image/png.

Codes d'erreur

400 Bad Request

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

401 Unauthorized

Clé d'accès absente ou invalide dans l'en-tête x-unico-accesskey. Voir Authentification.

403 Forbidden

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

404 Not Found

Processus introuvable, le processus s'est terminé sans capture biométrique, ou la fenêtre de rétention de 24 heures a expiré.

429 Too Many Requests

Rate limit reached. When your system receives an HTTP 429 error, you must implement mechanisms to prevent cascading failures and avoid worsening the restriction.

Best practices:

• Cool-down period (backoff): Immediately halt or throttle subsequent requests from your system. Do not continuously retry failed requests in a tight loop.
• Queueing & throttling: Buffer or queue outgoing requests on your end to control the traffic flow before re-sending them.
• Exponential backoff with jitter: When retrying, increase the waiting time exponentially between attempts (e.g., 1 s, 2 s, 4 s, 8 s) and add a small random delay ("jitter") to prevent a herd effect where all queued requests retry at the exact same millisecond.

avertissement

Continuously hitting a rate-limited endpoint without backing off can prolong the restriction period and severely impact your system's operational throughput. Properly throttling requests on your side ensures a smoother, more resilient integration.

For default limits, increase requests and additional details, see Rate Limits.

Prochaines étapes

• Pour le résultat complet du processus, consultez Récupérer un processus.
• Revenez à Créer un processus pour envoyer un nouveau selfie.