Zum Hauptinhalt springen
POST
Python
Selektiver Wiederholungsversuch erfordert die Identität des ursprünglichen anfragenden Benutzers. Ein API-Schlüssel oder ein Anwendungs-Token ohne diese Identität erhält beim Senden von item_ids den Statuscode 403, auch für die eigene Anwendung. Das generierte Beispiel für den API-Schlüssel führt den gesamten Export mit einem leeren Anfragetext erneut aus.
Die API von Didit für asynchrone Berichte führt einen Export erneut aus oder reiht ausgewählte fehlgeschlagene Verifizierungselemente in die Warteschlange ein. Ein neuer Wiederholungsversuch gibt 201 zurück; eine identische Auswahl fehlgeschlagener Elemente gibt den bestehenden Bericht mit 200 zurück. Lesen Sie die Live-IDs unter Asynchronen Bericht abrufen und folgen Sie der Anleitung zu Wiederholungsversuchen für fehlgeschlagene Elemente. Senden Sie 1 bis 1000 IDs aus einem SESSION_EXPORT mit dem Status READY oder FAILED, ohne einen ersetzenden Datumsbereich. Gelöschte Sitzungen können nicht wiederholt werden.

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

organization_id
string<uuid>
erforderlich

Organisations-ID.

application_id
string<uuid>
erforderlich

Anwendungs-ID.

report_uuid
string<uuid>
erforderlich

Berichts-UUID.

Body

application/json
item_ids
string<uuid>[]

Optionale Auswahl von 1 bis 1000 fehlgeschlagenen Live-Sitzungs-UUIDs aus diesem Export. Duplikate werden zu einem Eintrag zusammengefasst. Nur der ursprüngliche Anfragende darf eine Teilmenge erneut versuchen. Kann nicht mit date_from/date_to kombiniert werden.

Required array length: 1 - 1000 elements
date_from
string<date>

Optionaler neuer Beginn des Zeitraums. Senden Sie beide Daten in der richtigen Reihenfolge. Bei einem Wiederholungsversuch für fehlgeschlagene Elemente weglassen.

date_to
string<date>

Optionales neues Ende des Zeitraums, am oder nach date_from.

notify_on_ready
boolean
Standard:false

Den Anfordernden per E-Mail benachrichtigen, sobald der Bericht fertig ist, sofern eine E-Mail-Adresse des Anfordernden verfügbar ist.

Antwort

Identische Wiederholung einer Auswahl fehlgeschlagener Elemente; gibt den bestehenden Wiederholungsbericht zurück, ohne einen weiteren in die Warteschlange zu stellen.

uuid
string<uuid>
erforderlich

Berichts-ID.

report_type
enum<string>
erforderlich

Art des Exports oder Compliance-Berichts.

Verfügbare Optionen:
SESSION_EXPORT,
TRANSACTION_EXPORT,
BUSINESS_EXPORT,
VENDOR_USER_EXPORT,
VENDOR_BUSINESS_EXPORT,
CASE_EXPORT,
CASE_SLA_EXPORT,
LIST_ENTRY_EXPORT,
EVENT_EXPORT,
COMPLIANCE_KYC_KYB,
COMPLIANCE_AML_LOG,
COMPLIANCE_TRAVEL_RULE,
COMPLIANCE_SANCTIONS_PEP,
COMPLIANCE_RISK_SUMMARY,
COMPLIANCE_SAR_STR_DRAFT,
COMPLIANCE_CTR,
COMPLIANCE_CASE_SUMMARY
report_type_display
string
erforderlich

Anzeigebezeichnung für die Berichtsart.

status
enum<string>
erforderlich

Status der Generierung. READY kann einzelne Fehler enthalten; failed_count prüfen.

Verfügbare Optionen:
PENDING,
PROCESSING,
READY,
FAILED
status_display
string
erforderlich

Anzeigebezeichnung für den Generierungsstatus.

parameters
object
erforderlich

Ursprüngliche Exportoptionen. Die Schlüssel hängen vom report_type ab.

requested_by_user_id
string<uuid> | null
erforderlich

Identität des ursprünglichen Anfragenden oder null für Aufrufer ohne Benutzeridentität.

requested_by_email
string | null
erforderlich

E-Mail-Adresse des Anfragenden, sofern verfügbar.

requested_by_name
string | null
erforderlich

Anzeigename des Anfragenden, sofern verfügbar.

row_count
integer | null
erforderlich

Anzahl der exportierten Datensätze oder null vor der Generierung.

failed_item_ids
string<uuid>[]
erforderlich

Live-Sitzungs-UUIDs, die in diesem Verifizierungsexport fehlgeschlagen sind. Gelöschte Sitzungen sind ausgeschlossen. Verwenden Sie diese IDs für einen selektiven Wiederholungsversuch.

failed_count
integer
erforderlich

Anzahl der Einträge in failed_item_ids.

Erforderlicher Bereich: x >= 0
file_size
integer<int64> | null
erforderlich

Gesamtgröße der erzeugten Datei in Bytes oder null vor der Erzeugung.

files
object[]
erforderlich

Metadaten der generierten Datei; enthält keine Download-URLs.

scheduled_report
string<uuid> | null
erforderlich

Zeitplan-Kennung oder null bei einem nicht geplanten Bericht.

error_message
string | null
erforderlich

Fehler bei der Generierung, sofern verfügbar.

deletion_pending
boolean
erforderlich

Ob eine angeforderte Löschung noch läuft.

eta_seconds
integer | null
erforderlich

Geschätzte Sekunden bis zum Abschluss für einen ausstehenden oder in Verarbeitung befindlichen Bericht; null ohne Verlauf oder wenn der Bericht fertig ist.

started_at
string<date-time> | null
erforderlich

Startzeitpunkt der Generierung.

completed_at
string<date-time> | null
erforderlich

Zeitpunkt des Abschlusses der Generierung.

expires_at
string<date-time>
erforderlich

Ablaufzeitpunkt des Berichts.

created_at
string<date-time>
erforderlich

Erstellungszeitpunkt.

updated_at
string<date-time>
erforderlich

Zeitpunkt der letzten Aktualisierung.

Zuletzt geändert am 14. November 2026