Beweismittelpaket abrufen

Gibt das während der biometrischen Erfassung generierte Beweismittelpaket zurück — ein Paket, das die erfassten Bilder, Metadaten und Erfassungsartefakte enthält, die belegen, dass die Lebenderkennung unter kontrollierten Bedingungen durchgeführt wurde.

Nur für abgeschlossene Prozesse verfügbar (state = PROCESS_STATE_FINISHED).

Endpunkt

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

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/evidenceset \
  -H "Authorization: Bearer $TOKEN"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
  { headers: { Authorization: `Bearer ${accessToken}` } }
);
const { fileContents, contentType } = await res.json();
// fileContents is a base64-encoded PDF bundle

Antworten

200 OK

{
  "fileContents": "JVBERi0xLjMNCi...",
  "contentType": "application/pdf"
}

Feld	Typ	Beschreibung
fileContents	string (base64)	Das Beweismittelpaket, base64-kodiert.
contentType	string	MIME-Typ — in der Regel application/pdf.

400 Bad Request

Der Pfadparameter processId fehlt oder ist fehlerhaft. Siehe Fehlercodes unten.

401 Unauthorized

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

404 Not Found

Prozess nicht gefunden oder das Beweismittelpaket ist noch nicht verfügbar (Prozess nicht abgeschlossen).

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.

404 Not Found

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

500 Internal Server Error

Code	Nachricht	Beschreibung
99999	Internal failure! Try again later	Wenn ein interner Fehler aufgetreten ist.

Nächste Schritte

• Für das vollständige Prozessergebnis, siehe Prozess abrufen.
• Für das erfasste Selfie-Bild, siehe Selfie abrufen.