Zum Hauptinhalt springen
PATCH
curl
Die Feldschlüssel sind die, die Sie für das Dokument im Workflow konfiguriert haben. Informationen dazu, wie Dokumente und Felder eingerichtet werden, finden Sie unter Document AI. Im Document-AI-Bericht sehen Sie, wo das Ergebnis in der Sitzungsentscheidung erscheint.

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): Der Server löst die ID über beide Sitzungstypen hinweg auf. Muss eine wohlgeformte UUID sein; ein fehlerhafter Wert entspricht nicht der Route und gibt ein HTML-404 zurück.

Beispiel:

"11111111-2222-3333-4444-555555555555"

documentUuid
string<uuid>
erforderlich

UUID des Document AI-Dokuments (document_ai_documents[].items[].uuid in GET /v3/session/{sessionId}/decision/). Es muss zu der Sitzung im Pfad gehören.

Beispiel:

"44444444-5555-6666-7777-888888888888"

Body

application/json
extracted_data
object

Feldschlüssel (die von Ihnen für das Dokument konfigurierten Schlüssel) und deren korrigierte Werte. Muss ein JSON-Objekt sein; wird Schlüssel für Schlüssel in die gespeicherten Daten zusammengeführt. Lassen Sie das Feld lieber weg, anstatt null zu senden, was zu einem 400 führt.

Beispiel:
status
enum<string>

Neuer Prüfungsstatus des Dokuments.

Verfügbare Optionen:
Approved,
Declined,
In Review,
Not Finished
Beispiel:

"Approved"

Antwort

Dokument aktualisiert. Gibt das Dokument nach dem Merge zurück.

uuid
string<uuid>
erforderlich

Dokumentenbezeichner.

document_key
string
erforderlich

Das konfigurierte Dokument, dem dieser Upload entspricht.

original_filename
string | null
erforderlich

Dateiname, mit dem das Dokument hochgeladen wurde.

file_url
string | null
erforderlich

Speicherpfad der hochgeladenen Datei. Dies ist kein Download-Link: Lesen Sie die vorab signierte file_url aus der Sitzungsentscheidung aus, um die Datei herunterzuladen.

status
enum<string>
erforderlich

Prüfstatus des Dokuments.

Verfügbare Optionen:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
extracted_data
object | null
erforderlich

Alle extrahierten Felder nach der Zusammenführung, indexiert nach Feldschlüssel.

Zuletzt geändert am 7. November 2026