Vai al contenuto principale
POST
curl
Aggiungi alla blocklist ciò che una sessione di verifica ha raccolto: il volto, il documento d’identità, il numero di telefono o l’indirizzo email. Didit contrassegna ogni record selezionato come presente in blocklist e lo aggiunge alla blocklist di sistema corrispondente, collegato alla sessione. Le nuove sessioni con un volto, un numero di documento, un numero di telefono o un indirizzo email corrispondenti vengono rifiutate da quel momento in poi.
La chiamata è tutto o niente: se la sessione non contiene alcun record del tipo selezionato, oppure se il documento non ha il paese di emissione, il tipo di documento, il numero del documento o il nome completo, restituisce 400 e nulla viene aggiunto alla blocklist. Ripetere la chiamata per un elemento già presente in blocklist è sicuro.
Per verificare quali elementi sono bloccati, usa Elenca le voci in blocklist. Per rimuovere un blocco, usa Rimuovi dalla blocklist. Per bloccare un indirizzo IP, un’impronta digitale del dispositivo, un utente, un’azienda o un valore senza sessione, aggiungi una voce alla blocklist di sistema corrispondente con Crea voce. Consulta Blocklist utenti per capire come vengono applicate le blocklist.

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

Almeno un flag blocklist_* deve essere true.

session_id
string<uuid>
obbligatorio

Una sessione di verifica di una persona della tua applicazione. Le sessioni eliminate vengono rifiutate.

blocklist_face
boolean
predefinito:false

Aggiungi alla blocklist il volto della sessione.

blocklist_document
boolean
predefinito:false

Aggiungi alla blocklist il documento d'identità della sessione. Il documento necessita di stato di emissione, tipo di documento, numero di documento e nome completo.

blocklist_phone
boolean
predefinito:false

Aggiungi alla blocklist il numero di telefono della sessione.

blocklist_email
boolean
predefinito:false

Aggiungi alla blocklist l'indirizzo email della sessione.

Risposta

Gli elementi selezionati sono stati inseriti nella blocklist.

message
string
obbligatorio

Sempre Successfully updated blocklist.

Ultima modifica il 7 novembre 2026