Zum Hauptinhalt springen

Nachweispaket abrufen

Markdown

Gibt das während der biometrischen Erfassung erzeugte Nachweispaket zurück — ein Paket, das die erfassten Bilder, Metadaten und Erfassungsartefakte enthält, mit denen nachgewiesen wird, dass die Lebenderkennung unter kontrollierten Bedingungen durchgeführt wurde.

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

Endpunkt​

UmgebungURL
ProduktionGET https://api.idcloud.unico.app/client/v1/process/{processId}/evidenceset
SandboxGET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/evidenceset

Request​

Headers
HeaderWert
AuthorizationBearer <access_token> (siehe Authentifizierung)
Pfadparameter
ParameterTypErforderlichBeschreibung
processIdstring (UUID)jaProzesskennung, die von Prozess erstellen zurückgegeben wird.

Beispiel​

curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/evidenceset \
-H "Authorization: Bearer $TOKEN" \
| jq -r .fileContents | base64 --decode > evidence-set.pdf

Antworten​

200 OK
{
"fileContents": "JVBERi0xLjMNCi...",
"contentType": "x-pdf"
}
FeldTypBeschreibung
fileContentsstring (base64)Das PDF des Nachweispakets, base64-kodiert.
contentTypestringGibt derzeit x-pdf zurück.
Das PDF erstellen

x-pdf ist kein gültiger MIME-Typ, und Browser erkennen ihn nicht. Leiten Sie contentType nicht an den Browser weiter. Dekodieren Sie fileContents aus base64 und stellen Sie die Bytes als application/pdf bereit, wie im obigen Node.js-Beispiel.

Fehlercodes​

Hinweis

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

Der Pfadparameter processId fehlt oder ist fehlerhaft formatiert.

Nächste Schritte​