Zum Hauptinhalt springen
POST
curl
Erstellen Sie eine ZIP-Datei mit allen Dateien einer Sitzung der Benutzerverifizierung (KYC) oder Unternehmensverifizierung (KYB): Dokumentseiten, Selfies, Liveness-Videos und hochgeladene Dokumente in Originalqualität. Die ZIP-Datei wird im Hintergrund erstellt. Der Aufruf gibt 202 und den Export zurück. Rufen Sie den Export mit Dateiexport abrufen ab, bis status den Wert READY hat, und laden Sie dann download_url herunter.
  • Solange ein Export derselben Sitzung noch erstellt wird, gibt der Aufruf diesen Export zurück, statt einen neuen zu starten.
  • Die ZIP-Datei wird 24 Stunden nach ihrer Bereitstellung gelöscht und sofort, wenn die Sitzung gelöscht wird.
  • Eine gelöschte Sitzung kann nicht exportiert werden: Der Aufruf gibt 404 zurück.
  • Jeder Export wird im Audit-Log der Sitzung erfasst.
  • Ein eingeschränkter API-Schlüssel benötigt media: read und decisions: read.

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

sessionId
string<uuid>
erforderlich

UUID der Verifizierungssitzung (die von POST /v3/session/ zurückgegebene session_id). Akzeptiert Sitzungs-IDs sowohl für die Benutzerverifizierung (KYC) als auch für die Unternehmensverifizierung (KYB). Eine gelöschte Sitzung gibt 404 zurück.

Beispiel:

"11111111-2222-3333-4444-555555555555"

Antwort

Der Export wird vorbereitet.

Eine ZIP-Datei mit allen Dateien einer Sitzung in Originalqualität.

export_id
string<uuid>
erforderlich

ID des Exports. Übergeben Sie sie an GET /v3/session/{sessionId}/files-export/{exportId}/.

session_id
string<uuid>
erforderlich

Die Sitzung, aus der die Dateien stammen.

status
enum<string>
erforderlich

PENDING und PROCESSING, während die ZIP-Datei vorbereitet wird, READY, sobald sie heruntergeladen werden kann, FAILED, wenn sie nicht vorbereitet werden konnte (fordern Sie einen neuen Export an), EXPIRED, sobald die ZIP-Datei gelöscht wurde.

Verfügbare Optionen:
PENDING,
PROCESSING,
READY,
FAILED,
EXPIRED
file_count
integer | null
erforderlich

Dateien in der ZIP-Datei. Nur festgelegt, solange status auf READY steht.

size_bytes
integer<int64> | null
erforderlich

Größe der ZIP-Datei in Bytes. Nur gesetzt, während status auf READY steht.

download_url
string<uri> | null
erforderlich

Signierte URL der ZIP-Datei, gültig für kurze Zeit. Nur gesetzt, während status auf READY steht; rufen Sie den Export erneut ab, um eine neue zu erhalten.

expires_at
string<date-time> | null
erforderlich

Wann die ZIP-Datei gelöscht wird, 24 Stunden nachdem sie bereit war. Wird nur gesetzt, solange status den Wert READY hat.

error
string | null
erforderlich

Warum der Export fehlgeschlagen ist, wenn status den Wert FAILED hat.

created_at
string<date-time>
erforderlich

Wann der Export angefordert wurde.

completed_at
string<date-time> | null
erforderlich

Wann die ZIP-Datei bereit war oder der Export fehlgeschlagen ist.

Zuletzt geändert am 7. November 2026