Selfie abrufen

MarkdownChatGPTClaude

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.

Verfügbar für jeden abgeschlossenen Prozess, bei dem eine biometrische Erfassung durchgeführt wurde, einschließlich der Abläufe der Intelligenten Revalidierung (idsmart). Nicht verfügbar, wenn der Prozess ohne biometrische Erfassung abgeschlossen wurde (zum Beispiel bei einer stillen Authentifizierung), da es dann kein Selfie zurückzugeben gibt.

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.

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.

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 es kein Selfie zurückzugeben gibt.

Nächste Schritte

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