curl -X GET 'https://verification.didit.me/v3/lists/?list_type=blocklist' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.lists.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.lists.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.Lists.ListAutoPaging(ctx, didit.ListsListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.lists().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->lists->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.lists.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.Lists.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"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": 3,
"last_entry_added_at": "2026-10-02T08:15:27.501334Z",
"created_at": "2026-09-30T13:20:45.889120Z",
"updated_at": "2026-09-30T13:20:45.889120Z"
},
{
"uuid": "11111111-2222-3333-4444-555555555555",
"name": "Face Blocklist",
"description": "Blocked biometric faces. When a face matching an entry in this list is detected during liveness verification, the session will be automatically declined.",
"list_type": "blocklist",
"entry_type": "face",
"is_system": true,
"entry_count": 12,
"last_entry_added_at": "2026-10-09T16:42:03.118204Z",
"created_at": "2026-01-14T10:02:11.402917Z",
"updated_at": "2026-01-14T10:02:11.402917Z"
}
]
}واجهة Lists API: قوائم الحظر وقوائم السماح
GET /v3/lists/: استرداد جميع قوائم الحظر والسماح والقوائم المخصصة في Didit. التصفية حسب نوع القائمة أو نوع الإدخال. دفع لكل استدعاء بدون عقود.
curl -X GET 'https://verification.didit.me/v3/lists/?list_type=blocklist' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.lists.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.lists.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.Lists.ListAutoPaging(ctx, didit.ListsListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.lists().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->lists->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.lists.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.Lists.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"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": 3,
"last_entry_added_at": "2026-10-02T08:15:27.501334Z",
"created_at": "2026-09-30T13:20:45.889120Z",
"updated_at": "2026-09-30T13:20:45.889120Z"
},
{
"uuid": "11111111-2222-3333-4444-555555555555",
"name": "Face Blocklist",
"description": "Blocked biometric faces. When a face matching an entry in this list is detected during liveness verification, the session will be automatically declined.",
"list_type": "blocklist",
"entry_type": "face",
"is_system": true,
"entry_count": 12,
"last_entry_added_at": "2026-10-09T16:42:03.118204Z",
"created_at": "2026-01-14T10:02:11.402917Z",
"updated_at": "2026-01-14T10:02:11.402917Z"
}
]
}list_type أو entry_type، واقرأ قيم القائمة من خلال إدخالات القائمة.
راجع القوائم لمعرفة وظيفة كل نوع من القوائم أثناء التحقق وفحص المعاملات.التفويضات
مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.
معلمات الاستعلام
القوائم من هذا النوع فقط.
blocklist, allowlist, custom القوائم من نوع الإدخال هذا فقط.
face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, country, user, business, key ترتيب الفرز: -created_at (الأحدث أولاً، وهو الافتراضي) أو created_at (الأقدم أولاً).
-created_at, created_at حجم الصفحة. القيمة الافتراضية 50. القيمة الأعلى من 1000000 تُرجع 400؛ والقيمة الصفرية أو السالبة أو غير الرقمية ترجع إلى 50.
1 <= x <= 1000000فهرس يستند إلى الصفر للعنصر الأول المراد إرجاعه. يُفضل اتباع next. القيمة التي تزيد عن 1000000 تُرجع 400؛ والقيمة السالبة أو غير الرقمية ترجع تلقائياً إلى 0.
0 <= x <= 1000000الاستجابة
صفحة من القوائم.