Zum Hauptinhalt springen
POST
curl
Erstellen Sie eine Liste für Ihre Anwendung. Es können nur Listen vom Typ allowlist und custom erstellt werden: Didit stellt pro Eintragstyp eine systemseitige Blockliste bereit, zu der Sie über Eintrag erstellen Einträge hinzufügen. Wählen Sie entry_type sorgfältig aus: Der Wert kann später nicht mehr geändert werden, und er legt fest, wie jeder Wert bei seiner Hinzufügung validiert wird. Unter Listen finden Sie, was jeder Listentyp bewirkt.

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
name
string
erforderlich

Listenname. Muss sich vom Namen jeder anderen Liste der Anwendung unterscheiden, einschließlich Systemlisten.

Required string length: 1 - 255
list_type
enum<string>
erforderlich

allowlist oder custom. blocklist wird mit 400 abgewiesen.

Verfügbare Optionen:
allowlist,
custom
entry_type
enum<string>
erforderlich

Was die Liste enthält: face, document (Dokumentennummer), phone, email, ip_address (Adresse oder CIDR-Bereich), device_fingerprint, wallet_address, bank_account, country (ISO 3166-1 alpha-3), user oder business (Ihre vendor_data) oder key (eine beliebige Zeichenkette). Damit wird bestimmt, wie Eintragswerte validiert und abgeglichen werden. Kann später nicht mehr geändert werden.

Verfügbare Optionen:
face,
document,
phone,
email,
ip_address,
device_fingerprint,
wallet_address,
bank_account,
country,
user,
business,
key
description
string
Standard:""

Optionale Freitextbeschreibung.

Antwort

Die Liste wurde erstellt.

Eine Sperrliste, Positivliste oder benutzerdefinierte Liste einer Anwendung.

uuid
string<uuid>
erforderlich

Listen-Identifikator. Verwenden Sie ihn als list_uuid in den Listen- und Eintrag-Endpoints sowie als Wert einer Workflow- oder Transaktionsregel-Bedingung mit value_type: "list".

name
string
erforderlich

Listenname, eindeutig unter den Listen der Anwendung.

Maximum string length: 255
description
string
erforderlich

Freitext-Beschreibung. Leere Zeichenkette, wenn nicht festgelegt.

list_type
enum<string>
erforderlich

blocklist: Eine Übereinstimmung lehnt die Sitzung oder Transaktion ab (nur Systemlisten, eine pro Eintragstyp). allowlist: Übereinstimmende Elemente gelten als vertrauenswürdig, beispielsweise überspringt eine Gesichts-Allowlist die Aktion für doppelte Gesichter; überschreibt niemals eine Sperrlisten-Übereinstimmung. custom: Wird in Workflow- und Transaktionsregel-Bedingungen verwendet (value_type: "list").

Verfügbare Optionen:
blocklist,
allowlist,
custom
entry_type
enum<string>
erforderlich

Was die Liste enthält: face, document (Dokumentennummer), phone, email, ip_address (Adresse oder CIDR-Bereich), device_fingerprint, wallet_address, bank_account, country (ISO 3166-1 Alpha-3), user oder business (Ihre vendor_data) oder key (eine beliebige Zeichenkette). Damit wird bestimmt, wie Eintragswerte validiert und abgeglichen werden.

Verfügbare Optionen:
face,
document,
phone,
email,
ip_address,
device_fingerprint,
wallet_address,
bank_account,
country,
user,
business,
key
is_system
boolean
erforderlich

true für die von Didit bereitgestellten Listen: eine Sperrliste pro Eintragstyp (face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, user, business), die benutzerdefinierte Liste High Risk Countries und System-Positivlisten. Systemlisten können weder umbenannt noch bearbeitet oder gelöscht werden; Sie können deren Einträge hinzufügen und löschen.

entry_count
integer
erforderlich

Anzahl der Einträge, die sich derzeit in der Liste befinden.

Erforderlicher Bereich: x >= 0
last_entry_added_at
string<date-time> | null
erforderlich

Wann der neueste aktuelle Eintrag hinzugefügt wurde. null bei einer leeren Liste.

created_at
string<date-time>
erforderlich

Wann die Liste erstellt wurde.

updated_at
string<date-time>
erforderlich

Wann die Liste zuletzt aktualisiert wurde.

Zuletzt geändert am 7. November 2026