Vai al contenuto principale
POST
curl
Crea una lista per la tua applicazione. Puoi creare solo liste di tipo allowlist e custom: Didit predispone una blocklist di sistema per ogni tipo di voce, alla quale puoi aggiungere elementi con Crea voce. Scegli entry_type con attenzione: non può essere modificato in seguito e determina come viene convalidato ogni valore che aggiungi. Consulta Liste per capire cosa fa ciascun tipo di lista.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Corpo

application/json
name
string
obbligatorio

Nome della lista. Deve differire dal nome di ogni altra lista dell'applicazione, incluse le liste di sistema.

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

allowlist o custom. blocklist viene rifiutato con 400.

Opzioni disponibili:
allowlist,
custom
entry_type
enum<string>
obbligatorio

Cosa contiene la lista: face, document (numero del documento), phone, email, ip_address (indirizzo o intervallo CIDR), device_fingerprint, wallet_address, bank_account, country (ISO 3166-1 alpha-3), user o business (il tuo vendor_data), oppure key (qualsiasi stringa). Determina come vengono convalidati e confrontati i valori delle voci. Non può essere modificata in seguito.

Opzioni disponibili:
face,
document,
phone,
email,
ip_address,
device_fingerprint,
wallet_address,
bank_account,
country,
user,
business,
key
description
string
predefinito:""

Descrizione opzionale a testo libero.

Risposta

La lista è stata creata.

Una blocklist, allowlist o lista personalizzata di un'applicazione.

uuid
string<uuid>
obbligatorio

Identificatore della lista. Utilizzalo come list_uuid negli endpoint di lista e voci, e come valore di una condizione di regola di workflow o transazione con value_type: "list".

name
string
obbligatorio

Nome della lista, univoco tra le liste dell'applicazione.

Maximum string length: 255
description
string
obbligatorio

Descrizione in formato testo libero. Stringa vuota se non impostata.

list_type
enum<string>
obbligatorio

blocklist: una corrispondenza rifiuta la sessione o la transazione (solo liste di sistema, una per tipo di voce). allowlist: gli elementi corrispondenti sono attendibili, ad esempio un'allowlist dei volti salta l'azione per volto duplicato; non sovrascrive mai una corrispondenza con la blocklist. custom: utilizzato nelle condizioni delle regole del workflow e delle transazioni (value_type: "list").

Opzioni disponibili:
blocklist,
allowlist,
custom
entry_type
enum<string>
obbligatorio

Cosa contiene la lista: face, document (numero del documento), phone, email, ip_address (indirizzo o intervallo CIDR), device_fingerprint, wallet_address, bank_account, country (ISO 3166-1 alpha-3), user o business (il tuo vendor_data), oppure key (qualsiasi stringa). Determina come vengono convalidati e confrontati i valori delle voci.

Opzioni disponibili:
face,
document,
phone,
email,
ip_address,
device_fingerprint,
wallet_address,
bank_account,
country,
user,
business,
key
is_system
boolean
obbligatorio

true per le liste predisposte da Didit: una blocklist per tipo di voce (face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, user, business), la lista personalizzata High Risk Countries e le allowlist di sistema. Le liste di sistema non possono essere rinominate, modificate o eliminate; puoi aggiungerne ed eliminarne le voci.

entry_count
integer
obbligatorio

Numero di voci attualmente presenti nella lista.

Intervallo richiesto: x >= 0
last_entry_added_at
string<date-time> | null
obbligatorio

Quando è stata aggiunta la voce corrente più recente. null per una lista vuota.

created_at
string<date-time>
obbligatorio

Quando la lista è stata creata.

updated_at
string<date-time>
obbligatorio

Quando la lista è stata aggiornata l'ultima volta.

Ultima modifica il 7 novembre 2026