Zum Hauptinhalt springen
POST
Python

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 Unternehmensverifizierung (KYB). Sie muss zu der Anwendung des API-Schlüssels gehören.

Beispiel:

"33333333-4444-5555-6666-777777777777"

Abfrageparameter

node_id
string

Workflow-Knoten des KYB-Schritts. Nur erforderlich, wenn der Workflow mehr als einen KYB-Knoten enthält; standardmäßig verwendet Didit den sitzungseigenen Knoten.

Body

multipart/form-data
documents
file[]
erforderlich

Hochzuladende Dateien: JPG, JPEG, PNG, TIFF, WEBP, PDF oder ZIP-Archive dieser Dateien. PDFs bis zu 50 MB, Fotos bis zu 6 MB vor der Komprimierung.

document_passwords
string[]

Ein Eintrag pro Datei in documents, in derselben Reihenfolge: das Passwort eines geschützten PDFs, leer bei jeder anderen Datei.

document_group
enum<string>

Erforderliche Dokumentengruppe, auf die dieser Upload antwortet.

Verfügbare Optionen:
LEGAL_PRESENCE,
COMPANY_DETAILS,
OWNERSHIP_STRUCTURE,
REPRESENTATIVES_AUTHORIZATION
locale
string

Gebietsschema zur Übersetzung der Antwort des nächsten Schritts.

Maximum string length: 10

Antwort

Dokumente verarbeitet. Wenn jede erforderliche Gruppe erfüllt ist, schreitet die Sitzung voran und next_step benennt den nächsten Schritt; andernfalls verbleibt sie beim Schritt Documents und document_groups sowie document_answer geben an, was noch fehlt.

valid
boolean
next_step
string | null

Schritt, in dem sich die Sitzung nach dem Upload befindet.

kyb_status
string

Status der Unternehmensprüfung.

document_answer
object

Ergebnis pro hochgeladenem Dokument und verbleibende Uploads.

Zuletzt geändert am 7. November 2026