Inizia
Integrazione / SDK
Verifica degli utenti
Verifica aziendale
Monitoraggio delle transazioni
Changelogcurl -X POST 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/entries/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"value": "+14155552671", "comment": "Reported fraud"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.lists.entries.create(
"11111111-2222-3333-4444-555555555555",
value="+14155552671",
comment="Reported fraud",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.lists.entries.create("11111111-2222-3333-4444-555555555555", {
value: "+14155552671",
comment: "Reported fraud",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Lists.Entries.Create(ctx, "11111111-2222-3333-4444-555555555555", didit.ListsEntriesCreateParams{
Value: didit.String("+14155552671"),
Comment: didit.String("Reported fraud"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.ListsEntriesCreateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.lists().entries().create("11111111-2222-3333-4444-555555555555", ListsEntriesCreateParams.builder()
.value("+14155552671")
.comment("Reported fraud")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->lists->entries->create('11111111-2222-3333-4444-555555555555', [
'value' => '+14155552671',
'comment' => 'Reported fraud',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.lists.entries.create(
"11111111-2222-3333-4444-555555555555",
value: "+14155552671",
comment: "Reported fraud"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Lists.Entries.CreateAsync("11111111-2222-3333-4444-555555555555", new ListsEntriesCreateParams
{
Value = "+14155552671",
Comment = "Reported fraud",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"value": "+14155552671",
"display_label": "",
"comment": "Reported fraud",
"added_by": "api",
"reference_session_id": null,
"reference_session_number": null,
"reference_session_type": null,
"reference_object_uuid": null,
"metadata": null,
"created_at": "2026-10-12T10:04:51.220391Z"
}Crea voce blocklist API: allowlist e blocklist Didit
Aggiungi una voce (volto, documento, IP, wallet, email, telefono) a una blocklist o allowlist Didit. Controlli antifrode programmatici via API.
curl -X POST 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/entries/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"value": "+14155552671", "comment": "Reported fraud"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.lists.entries.create(
"11111111-2222-3333-4444-555555555555",
value="+14155552671",
comment="Reported fraud",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.lists.entries.create("11111111-2222-3333-4444-555555555555", {
value: "+14155552671",
comment: "Reported fraud",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Lists.Entries.Create(ctx, "11111111-2222-3333-4444-555555555555", didit.ListsEntriesCreateParams{
Value: didit.String("+14155552671"),
Comment: didit.String("Reported fraud"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.ListsEntriesCreateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.lists().entries().create("11111111-2222-3333-4444-555555555555", ListsEntriesCreateParams.builder()
.value("+14155552671")
.comment("Reported fraud")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->lists->entries->create('11111111-2222-3333-4444-555555555555', [
'value' => '+14155552671',
'comment' => 'Reported fraud',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.lists.entries.create(
"11111111-2222-3333-4444-555555555555",
value: "+14155552671",
comment: "Reported fraud"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Lists.Entries.CreateAsync("11111111-2222-3333-4444-555555555555", new ListsEntriesCreateParams
{
Value = "+14155552671",
Comment = "Reported fraud",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"value": "+14155552671",
"display_label": "",
"comment": "Reported fraud",
"added_by": "api",
"reference_session_id": null,
"reference_session_number": null,
"reference_session_type": null,
"reference_object_uuid": null,
"metadata": null,
"created_at": "2026-10-12T10:04:51.220391Z"
}- email: un indirizzo email valido
- telefono: un numero di telefono internazionale valido, memorizzato in formato E.164 (ad esempio
+14155552671) - ip_address: un indirizzo IP valido o un intervallo CIDR (ad esempio
192.168.1.1o10.0.0.0/8) - device_fingerprint: almeno 8 caratteri tra lettere, cifre,
-,_,:e.. Una blocklist rifiuta un fingerprint che più dispositivi distinti hanno segnalato, perché bloccarlo bloccherebbe persone non collegate - paese: un codice paese ISO 3166-1 alpha-3 valido (ad esempio
USA,GBR,ESP). I codici alpha-2 (ad esempioUS) sono accettati e convertiti automaticamente in alpha-3 - utente, azienda: il
vendor_datadell’utente o dell’azienda - volto, documento, wallet_address, bank_account, chiave: qualsiasi stringa non vuota
User@Example.COM verrà intercettato anche user@example.com. Una lista contiene ogni valore una sola volta: l’aggiunta di un valore già presente nella lista restituisce 400.reference_session_id per prendere il volto di una sessione esistente. Una voce di tipo volto richiede un volto memorizzato con cui confrontarsi, che un value digitato non fornisce.
Aggiunta da una sessione
Quando fornisci unreference_session_id, Didit:
- Cerca la sessione (deve appartenere alla stessa applicazione)
- Legge il valore dal record più recente della sessione relativo al tipo di voce della lista:
- volto: il volto del selfie di prova di vitalità;
valueè l’UUID del volto - documento: il numero del documento; il nome completo, lo stato di emissione, il tipo di documento, la regione e il numero del documento vengono memorizzati in
metadata, edisplay_labelè impostato per default con il nome del titolare e il numero del documento - telefono: il numero di telefono
- email: l’indirizzo email
- ip_address: l’indirizzo IP della sessione
- device_fingerprint: un fingerprint che identifica un dispositivo, con preferenza per un dispositivo che ha completato un passaggio di verifica. In una blocklist, Didit rifiuta una sessione che ha solo un fingerprint di classe dispositivo, oppure uno completato su più di un dispositivo: in tal caso invia il fingerprint esatto come
value
- volto: il volto del selfie di prova di vitalità;
- Collega la voce alla sessione (
reference_session_id) e al record (reference_object_uuid) per la tracciabilità
value.
Restituisce 400 se la sessione non viene trovata o non contiene dati per il tipo di voce richiesto.
Volti dal selfie della cattura del documento
Mentre l’utente fotografa il documento, la fotocamera frontale può scattare un selfie (le immaginifront_image_camera_front e back_image_camera_front del report di verifica dell’identità). Quel volto può essere aggiunto anche alla blocklist dei volti, oltre al volto della prova di vitalità: passa face_image_source con l’immagine che desideri.
{
"reference_session_id": "33333333-4444-5555-6666-777777777777",
"face_image_source": "front_image_camera_front"
}
- La voce viene creata solo nella blocklist dei volti di sistema, e
valuedeve essere lasciato vuoto: Didit prende il volto dal selfie della sessione. - Il selfie deve contenere un solo volto ben visibile. In caso contrario la richiesta restituisce
400e non viene aggiunto nulla. - Ogni selfie può essere aggiunto una sola volta.
metadata.face_image_sourceemetadata.reference_node_iddella voce indicano da quale selfie proviene. - In un workflow con più di un passaggio di verifica dell’identità,
reference_node_idsceglie il passaggio di cui usare il selfie. Per default Didit usa la verifica dell’identità più recente che ha quel selfie. - Da quel momento il volto viene controllato come qualsiasi altro volto in blocklist: contro il selfie di prova di vitalità di ogni nuova sessione e contro ogni nuovo selfie della cattura del documento (vedi
FRONT_CAMERA_FACE_IN_BLOCKLIST). - Eliminare la voce rimuove il volto dalla blocklist e il volto non verrà più confrontato con le nuove sessioni.
Sessioni con più record dello stesso tipo
Una sessione può contenere più record di un tipo, ad esempio due numeri di telefono da un workflow in più passaggi. Didit legge sempre quello più recente. Se inviivalue insieme a reference_session_id, la voce memorizza il tuo value ma resta collegata a quel record più recente, e in una blocklist di sistema è quel record a essere contrassegnato.
Per inserire in lista un valore da un record precedente, aggiungilo solo tramite value, senza reference_session_id:
{
"value": "+34612345678",
"comment": "First phone number of session 42"
}
Riferimenti a transazioni, utenti e aziende
Quando aggiungi alla blocklist dati di una transazione o di un utente o di un’azienda del fornitore, passa l’UUID dell’entità comereference_object_uuid e indica il tipo di origine in metadata:
{
"value": "0x52908400098527886E0F7030069857D2E4169EE7",
"reference_object_uuid": "55555555-6666-7777-8888-999999999999",
"metadata": {
"reference_type": "transaction",
"reference_id": "55555555-6666-7777-8888-999999999999"
}
}
metadata che invii, tranne reference_image_url e front_image_url, che imposta solo Didit. Per una voce letta da una sessione, Didit aggiunge le proprie chiavi alle tue, e le sue chiavi prevalgono.
| Entità di origine | reference_object_uuid | metadata.reference_type |
|---|---|---|
| Sessione di verifica | Impostato da Didit (il record del volto, del documento, del telefono o dell’email) | Non necessario: usa reference_session_id |
| Transazione | UUID della transazione | "transaction" |
| Utente del fornitore | didit_internal_id | "vendor_user" |
| Azienda del fornitore | didit_internal_id | "vendor_business" |
BLOCKED: quelli il cui vendor_data è uguale a value, oppure il cui didit_internal_id è uguale a reference_object_uuid. Vedi blocklist degli utenti e blocklist delle aziende.Autorizzazioni
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.
Parametri del percorso
UUID della lista a cui aggiungere l'elemento. Per un volto disponibile solo come immagine, usa invece Upload a face to a list.
Corpo
Invia value, reference_session_id o entrambi. I campi applicabili dipendono dall'entry_type della lista.
Il valore da inserire nell'elenco, validato rispetto all'entry_type della lista: email un indirizzo email valido; phone un numero internazionale valido, memorizzato in formato E.164; ip_address un indirizzo IP o un intervallo CIDR (ad esempio 10.0.0.0/8); device_fingerprint almeno 8 caratteri tra lettere, cifre, -, _, : e . (una blocklist rifiuta un'impronta segnalata da diversi dispositivi distinti); country un codice ISO 3166-1 alpha-2 o alpha-3, memorizzato come alpha-3; user e business il vendor_data; qualsiasi altro tipo una stringa non vuota. Memorizzato in minuscolo tranne i numeri di telefono e i codici paese, e una lista contiene ciascun valore una sola volta (senza distinzione tra maiuscole e minuscole). Obbligatorio a meno che non venga inviato reference_session_id; deve essere lasciato vuoto con un face_image_source di acquisizione del documento.
Una sessione di verifica di una persona o di un'azienda della tua applicazione da cui acquisire il valore. Didit legge il record più recente della sessione corrispondente al tipo di voce della lista (face, document, phone, email, ip_address o device_fingerprint), collega la voce alla sessione e a quel record e compila display_label e metadata per i documenti. Per una blocklist di tipo device_fingerprint, una sessione che dispone solo di un'impronta di classe dispositivo, o che è stata completata su più dispositivi, viene rifiutata: invia l'impronta esatta come value. Per altri tipi di voce, o quando la sessione non contiene tale record, invia anche value; in tal caso, il tuo value viene memorizzato e la voce rimane comunque collegata alla sessione.
UUID del record rappresentato dalla voce quando non proviene da una sessione: un UUID di transazione oppure il didit_internal_id di un utente o di un'azienda. Abbinalo a metadata.reference_type. Sostituito dal record della sessione quando reference_session_id ne fornisce uno.
Elenchi di volti con reference_session_id: da quale delle immagini della sessione viene estratto il volto. liveness (impostazione predefinita) è il selfie di rilevamento della vitalità. front_image_camera_front e back_image_camera_front sono i selfie scattati dalla fotocamera anteriore mentre l'utente fotografava il fronte o il retro del proprio documento: accettati solo sulla blocklist di volti di sistema, con reference_session_id e un value vuoto. Ciascun selfie può essere aggiunto una sola volta e deve mostrare un unico volto ben visibile.
liveness, front_image_camera_front, back_image_camera_front Con un face_image_source di acquisizione del documento: il nodo di verifica dell'identità di cui usare il selfie, per i workflow che ne contengono più di uno. Il valore predefinito è la verifica dell'identità più recente contenente tale immagine. Rifiutato con liveness.
100Etichetta di facile lettura. Se vuota, Didit ne ricava una dalla sessione ove possibile (ad esempio il nome del titolare e il numero del documento).
512Nota in formato testo libero, ad esempio il motivo dell'inclusione nella lista.
JSON a struttura libera memorizzato con la voce e restituito così come memorizzato. Usa reference_type e reference_id affinché la console rimandi alla fonte. reference_image_url e front_image_url sono impostati esclusivamente da Didit e vengono rimossi se li invii. Per una voce letta da una sessione, le chiavi di Didit vengono unite alle tue.
Show child attributes
Show child attributes
Risposta
La voce è stata creata.
Un singolo valore in una lista.
Identificatore della voce. Utilizzalo come entry_uuid in Elimina una voce dell'elenco.
Il valore inserito in lista: un numero di telefono in formato E.164, un indirizzo email, un numero di documento, un indirizzo IP o un intervallo CIDR, un'impronta digitale del dispositivo, un indirizzo del wallet, un conto bancario, un codice paese ISO 3166-1 alpha-3, un vendor_data, qualsiasi stringa su una lista key, oppure l'UUID del volto memorizzato su una lista di volti. I valori inviati vengono memorizzati in minuscolo, ad eccezione dei numeri di telefono e dei codici paese. La corrispondenza non fa distinzione tra maiuscole e minuscole.
Etichetta di facile lettura. Didit la compila per le voci estratte da una sessione (ad esempio il nome del titolare e il numero del documento) quando non ne invii nessuna.
512Nota in formato testo libero. Stringa vuota se non impostata.
Chi ha aggiunto la voce: api (una chiave API), l'indirizzo email di un utente della console o console, system o migration (voci create da Didit), oppure rule (un'azione di una regola di transazione o monitoraggio).
Sessione di verifica da cui è stata estratta la voce. null quando la voce è stata aggiunta per valore.
Numero della sessione con ambito limitato all'applicazione, come mostrato nella console.
kyc per una sessione di verifica di una persona fisica, kyb per una sessione di verifica aziendale, null quando non è presente alcuna sessione.
kyc, kyb, null Il record rappresentato dalla voce: il record del volto, del documento, del telefono o dell'email letto da una sessione, il volto creato tramite Upload a face to a list, o l'UUID inviato (ad esempio l'UUID di una transazione o il didit_internal_id di un utente).
Contesto aggiuntivo. Contiene le chiavi impostate da Didit (elencate qui) unite a qualsiasi metadata inviato durante la creazione della voce, restituite così come memorizzate. null se non è presente alcuno.
Show child attributes
Show child attributes
Data e ora di aggiunta della voce.