Zum Hauptinhalt springen
POST
Python
Prüft die signierten Dokumente eines Schritts erneut und speichert das Ergebnis in validation jedes Unterzeichners. Didit liest jedes signierte PDF erneut und prüft dessen SHA-256-Wert. Bei einer fortgeschrittenen (AES-)Signatur validiert Didit zusätzlich die PAdES-Signatur, das Zertifikat, die Sperrdaten und den Zeitstempel. Eine einfache Signatur hat keine digitale Signatur, daher wird nur die Integrität der Datei geprüft. Es wird nichts erneut signiert. In der Konsole ist dies die Schaltfläche Erneut validieren auf der Registerkarte Signatur der Sitzung.
Übergeben Sie signature_id, um einen einzelnen Unterzeichner zu prüfen. Ohne diesen Parameter prüft Didit alle Unterzeichner des Schritts und antwortet mit 409 und signature_not_signed, wenn einer von ihnen noch nicht unterschrieben hat. Ein gespeichertes signiertes PDF, das nicht mehr mit sha256_signed übereinstimmt, führt zu einer 400-Antwort mit signature_document_changed. Die Antwort ist { "signatures": [...] } mit den geprüften Unterzeichnern. Das Gesamtergebnis finden Sie in validation.valid, die Angaben zu jedem Dokument in validation.documents[]. Alle Felder sind unter Eine Signatur erneut validieren beschrieben.

Verwandte Themen

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

Die Sitzung zur Benutzerverifizierung (KYC) oder Unternehmensverifizierung (KYB).

Beispiel:

"11111111-2222-3333-4444-555555555555"

nodeId
string
erforderlich

Der E-Signatur-Schritt: node_id des Elements in signatures[].

Beispiel:

"feature_signature"

Body

application/json
signature_id
string<uuid>

id des Eintrags eines Unterzeichners in signatures[].

Antwort

Die geprüften Unterzeichner mit ihrer aktualisierten validation.

signatures
object[]
Zuletzt geändert am 7. November 2026