curl -X POST 'https://verification.didit.me/v3/lists/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "Trusted office IPs",
"description": "Office egress ranges",
"list_type": "allowlist",
"entry_type": "ip_address"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.lists.create(
name="Trusted office IPs",
description="Office egress ranges",
list_type="allowlist",
entry_type="ip_address",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.lists.create({
name: "Trusted office IPs",
description: "Office egress ranges",
list_type: "allowlist",
entry_type: "ip_address",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Lists.Create(ctx, didit.ListsCreateParams{
Name: "Trusted office IPs",
Description: didit.String("Office egress ranges"),
ListType: "allowlist",
EntryType: "ip_address",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.ListsCreateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.lists().create(ListsCreateParams.builder()
.name("Trusted office IPs")
.description("Office egress ranges")
.listType(ListsCreateParams.ListType.of("allowlist"))
.entryType(ListsCreateParams.EntryType.of("ip_address"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->lists->create([
'name' => 'Trusted office IPs',
'description' => 'Office egress ranges',
'list_type' => 'allowlist',
'entry_type' => 'ip_address',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.lists.create(
name: "Trusted office IPs",
description: "Office egress ranges",
list_type: "allowlist",
entry_type: "ip_address"
)
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.CreateAsync(new ListsCreateParams
{
Name = "Trusted office IPs",
Description = "Office egress ranges",
ListType = "allowlist",
EntryType = "ip_address",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "22222222-3333-4444-5555-666666666666",
"name": "Trusted office IPs",
"description": "Office egress ranges",
"list_type": "allowlist",
"entry_type": "ip_address",
"is_system": false,
"entry_count": 0,
"last_entry_added_at": null,
"created_at": "2026-10-12T09:15:44.031876Z",
"updated_at": "2026-10-12T09:15:44.031876Z"
}API Crea lista: allowlist e lista personalizzata
Crea con POST /v3/lists/ una allowlist o lista personalizzata in Didit. Blocklist di sistema automatiche. Pagamento a chiamata, senza contratti.
curl -X POST 'https://verification.didit.me/v3/lists/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "Trusted office IPs",
"description": "Office egress ranges",
"list_type": "allowlist",
"entry_type": "ip_address"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.lists.create(
name="Trusted office IPs",
description="Office egress ranges",
list_type="allowlist",
entry_type="ip_address",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.lists.create({
name: "Trusted office IPs",
description: "Office egress ranges",
list_type: "allowlist",
entry_type: "ip_address",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Lists.Create(ctx, didit.ListsCreateParams{
Name: "Trusted office IPs",
Description: didit.String("Office egress ranges"),
ListType: "allowlist",
EntryType: "ip_address",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.ListsCreateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.lists().create(ListsCreateParams.builder()
.name("Trusted office IPs")
.description("Office egress ranges")
.listType(ListsCreateParams.ListType.of("allowlist"))
.entryType(ListsCreateParams.EntryType.of("ip_address"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->lists->create([
'name' => 'Trusted office IPs',
'description' => 'Office egress ranges',
'list_type' => 'allowlist',
'entry_type' => 'ip_address',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.lists.create(
name: "Trusted office IPs",
description: "Office egress ranges",
list_type: "allowlist",
entry_type: "ip_address"
)
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.CreateAsync(new ListsCreateParams
{
Name = "Trusted office IPs",
Description = "Office egress ranges",
ListType = "allowlist",
EntryType = "ip_address",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "22222222-3333-4444-5555-666666666666",
"name": "Trusted office IPs",
"description": "Office egress ranges",
"list_type": "allowlist",
"entry_type": "ip_address",
"is_system": false,
"entry_count": 0,
"last_entry_added_at": null,
"created_at": "2026-10-12T09:15:44.031876Z",
"updated_at": "2026-10-12T09:15:44.031876Z"
}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
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
Nome della lista. Deve differire dal nome di ogni altra lista dell'applicazione, incluse le liste di sistema.
1 - 255allowlist o custom. blocklist viene rifiutato con 400.
allowlist, custom 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.
face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, country, user, business, key Descrizione opzionale a testo libero.
Risposta
La lista è stata creata.
Una blocklist, allowlist o lista personalizzata di un'applicazione.
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".
Nome della lista, univoco tra le liste dell'applicazione.
255Descrizione in formato testo libero. Stringa vuota se non impostata.
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").
blocklist, allowlist, custom 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.
face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, country, user, business, key 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.
Numero di voci attualmente presenti nella lista.
x >= 0Quando è stata aggiunta la voce corrente più recente. null per una lista vuota.
Quando la lista è stata creata.
Quando la lista è stata aggiornata l'ultima volta.