Zum Hauptinhalt springen
POST
curl
Sperren Sie, was eine Verifizierungssitzung erfasst hat: das Gesicht, das Ausweisdokument, die Telefonnummer oder die E-Mail-Adresse. Didit markiert jeden ausgewählten Datensatz als gesperrt, fügt ihn der passenden Systemsperrliste hinzu und verknüpft ihn mit der Sitzung. Neue Sitzungen mit einem übereinstimmenden Gesicht, einer übereinstimmenden Dokumentnummer, Telefonnummer oder E-Mail-Adresse werden ab diesem Zeitpunkt abgelehnt.
Der Aufruf wirkt entweder vollständig oder gar nicht: Hat die Sitzung keinen Datensatz des ausgewählten Typs oder fehlt dem Dokument das Ausstellungsland, der Dokumenttyp, die Dokumentnummer oder der vollständige Name, gibt der Aufruf 400 zurück und es wird nichts gesperrt. Ein wiederholter Aufruf für ein bereits gesperrtes Element ist unbedenklich.
Um zu prüfen, was gesperrt ist, verwenden Sie Gesperrte Elemente auflisten. Um eine Sperre aufzuheben, verwenden Sie Aus der Sperrliste entfernen. Um eine Adresse, einen Geräte-Fingerprint, einen Benutzer, ein Unternehmen oder einen Wert ohne Sitzung zu sperren, fügen Sie einen Eintrag zur passenden Systemsperrliste hinzu, und zwar mit Eintrag erstellen. Informationen darüber, wie Sperrlisten angewendet werden, finden Sie unter Benutzer-Sperrliste.

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.

Body

application/json

Mindestens ein blocklist_*-Flag muss true sein.

session_id
string<uuid>
erforderlich

Eine Benutzerverifizierungssitzung Ihrer Anwendung. Gelöschte Sitzungen werden abgelehnt.

blocklist_face
boolean
Standard:false

Gesicht der Sitzung auf die Sperrliste setzen.

blocklist_document
boolean
Standard:false

Ausweisdokument der Sitzung auf die Sperrliste setzen. Das Dokument benötigt Ausstellungsstaat, Dokumenttyp, Dokumentnummer und vollständigen Namen.

blocklist_phone
boolean
Standard:false

Telefonnummer der Sitzung auf die Sperrliste setzen.

blocklist_email
boolean
Standard:false

E-Mail-Adresse der Sitzung auf die Sperrliste setzen.

Antwort

Die ausgewählten Elemente wurden auf die Sperrliste gesetzt.

message
string
erforderlich

Immer Successfully updated blocklist.

Zuletzt geändert am 7. November 2026