Zum Hauptinhalt springen
GET
curl
Rufen Sie einen Export ab, der mit Dateien exportieren gestartet wurde.
  • PENDING und PROCESSING: Die ZIP-Datei wird vorbereitet. Rufen Sie den Export nach einigen Sekunden erneut ab.
  • READY: download_url ist ein signierter Link zur ZIP-Datei, der nur für kurze Zeit gültig ist. Rufen Sie den Export erneut ab, um einen neuen Link zu erhalten, bis expires_at erreicht ist.
  • FAILED: Die ZIP-Datei konnte nicht vorbereitet werden. Starten Sie einen neuen Export.
  • EXPIRED: Die ZIP-Datei wurde gelöscht. Starten Sie einen neuen Export.
Jeder Abruf, der einen Download-Link ausgibt, wird im Audit-Log der Sitzung protokolliert. Ein Export einer gelöschten Sitzung gibt 404 zurück.

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"

exportId
string<uuid>
erforderlich

Die von POST /v3/session/{sessionId}/files-export/ zurückgegebene export_id.

Beispiel:

"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"

Antwort

Der Export.

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