Selfie abrufen

MarkdownChatGPTClaude

Gibt das biometrische Selfie zurück, das der Nutzer während der von Unico gehosteten Journey erfasst hat. Das Bild wird als base64-kodierte Zeichenfolge mit angewendetem Wasserzeichen zurückgegeben.

Verfügbar für jeden abgeschlossenen Prozess, bei dem eine biometrische Erfassung durchgeführt wurde, einschließlich Intelligente-Revalidierung-Journeys (idsmart). Nicht verfügbar, wenn der Prozess ohne biometrische Erfassung abgeschlossen wurde (z. B. bei einer stillen Authentifizierung), da in diesem Fall kein Selfie zum Zurückgeben vorhanden ist.

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

Request

Headers

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 ist eine base64-kodierte Bild-Zeichenfolge

Antworten

200 OK

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

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

Fehlercodes

Hinweis

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

400 Bad Request

Der Pfadparameter processId fehlt oder ist fehlerhaft formatiert.

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 der Prozess wurde ohne biometrische Erfassung abgeschlossen, sodass kein Selfie zum Zurückgeben vorhanden ist.

Nächste Schritte

• Für das vollständige Prozessergebnis siehe Prozess abrufen.
• Für das Nachweispaket zur Prüfung siehe Nachweispaket abrufen.