Selfie abrufen

Gibt das biometrische Selfie zurück, das der Benutzer während des von Unico gehosteten Ablaufs aufgenommen hat. Das Bild wird als base64-kodierter String mit einem aufgebrachten Wasserzeichen zurückgegeben.

Nur verfügbar für Prozesse, bei denen eine biometrische Erfassung stattgefunden hat (jeder Flow, der Liveness oder Identitätsverifizierung umfasst). Nicht verfügbar für Smart Revalidation Flows (idsmart).

Endpunkt

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

Anfrage

Header

Header	Wert
Authorization	Bearer <access_token> (siehe Authentifizierung)

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
processId	string (UUID)	ja	Prozesskennung, die von Prozess erstellen zurückgegeben wird.

Beispiel

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

Antworten

200 OK

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

Feld	Typ	Beschreibung
fileContents	string (base64)	Das aufgenommene Selfie, base64-kodiert. Enthält ein Wasserzeichen.
contentType	string	MIME-Typ des Bildes — image/jpeg oder image/png.

400 Bad Request

Der Pfadparameter processId fehlt oder ist fehlerhaft.

401 Unauthorized

Bearer-Token fehlt, ist abgelaufen oder ungültig. Siehe Authentifizierung.

403 Forbidden

Unzureichende Berechtigungen für den Zugriff auf das Selfie dieses Prozesses.

404 Not Found

Prozess nicht gefunden oder das Selfie ist für diesen Prozess nicht verfügbar (z. B. Smart Revalidation Flow).

Fehlercodes

Hinweis

Die API stellt für diesen Endpunkt keine spezifischen code- oder message-Werte bereit.

400 Bad Request

Für diesen Status sind keine spezifischen code- oder message-Werte dokumentiert.

401 Unauthorized

Für diesen Status sind keine spezifischen code- oder message-Werte dokumentiert.

403 Forbidden

Für diesen Status sind keine spezifischen code- oder message-Werte dokumentiert.

404 Not Found

Für diesen Status sind keine spezifischen code- oder message-Werte dokumentiert.

Nächste Schritte

• Für das vollständige Prozessergebnis siehe Prozess abrufen.
• Für das Beweismittel-Prüfungspaket siehe Beweismittelset abrufen.