Zum Hauptinhalt springen
PATCH
curl
Die vorsignierten Links in extra_files laufen ab. Rufen Sie bei Bedarf später neue Links aus der Sitzungsentscheidung ab, wenn Sie die Dateien benötigen. Um stattdessen die aus einem Dokument extrahierten Daten zu korrigieren, verwenden Sie Sitzungsdaten aktualisieren.

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 Sitzung zur Benutzerverifizierung (KYC), zu der die Datei hinzugefügt werden soll (die von POST /v3/session/ zurückgegebene session_id). Eine Sitzungs-ID der Unternehmensverifizierung (KYB) gibt 404 zurück.

Beispiel:

"11111111-2222-3333-4444-555555555555"

Body

multipart/form-data
file
file
erforderlich

Das Bild oder PDF. Zulässige Dateiendungen: jpg, jpeg, png, webp, tiff, pdf. Maximal 15 MB beim Hochladen; die Datei wird anschließend komprimiert und mit 400 abgelehnt, falls sie weiterhin größer als 2 MB (2.097.152 Bytes) ist. Leere Dateien werden abgelehnt.

model_type
enum<string>
erforderlich

kyc fügt die Datei dem Ergebnis der Ausweisverifizierung hinzu, poa dem Ergebnis des Adressnachweises.

Verfügbare Optionen:
kyc,
poa
Beispiel:

"kyc"

file_password
string

Passwort einer verschlüsselten PDF-Datei. Ohne dieses oder mit einem falschen Passwort gibt eine verschlüsselte PDF-Datei 400 zurück.

Antwort

Datei hinzugefügt. Gibt jede zusätzliche Datei dieses Ergebnisses zurück, einschließlich der neuen.

extra_files
(string<uri> | null)[]
erforderlich

Kurzlebige vorsignierte Links zu allen zusätzlichen Dateien des durch model_type benannten Ergebnisses, älteste zuerst. Jeder Link ist null für einen berechtigungseingeschränkten API-Schlüssel ohne media: read. Rufen Sie frische Links später aus der Sitzungsentscheidung ab.

Zuletzt geändert am 7. November 2026