मुख्य सामग्री पर जाएं
POST
curl
अपने एप्लिकेशन के लिए एक सूची बनाएँ। केवल allowlist और custom सूचियाँ बनाई जा सकती हैं: Didit हर प्रविष्टि प्रकार के लिए एक सिस्टम ब्लॉकलिस्ट प्रदान करता है, और आप एंट्री बनाएँ के माध्यम से उसमें जोड़ते हैं। entry_type को सावधानी से चुनें: इसे बाद में बदला नहीं जा सकता, और यही तय करता है कि जोड़े गए हर मान की जाँच कैसे होगी। हर सूची प्रकार क्या करता है, यह जानने के लिए सूचियाँ देखें।

प्राधिकरण

x-api-key
string
header
आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

बॉडी

application/json
name
string
आवश्यक

सूची का नाम। यह एप्लिकेशन की हर दूसरी सूची के नाम से भिन्न होना चाहिए, जिसमें सिस्टम सूचियाँ भी शामिल हैं।

Required string length: 1 - 255
list_type
enum<string>
आवश्यक

allowlist या custom। blocklist को 400 के साथ अस्वीकार कर दिया जाता है।

उपलब्ध विकल्प:
allowlist,
custom
entry_type
enum<string>
आवश्यक

सूची में क्या समाहित है: face, document (दस्तावेज़ संख्या), phone, email, ip_address (IP पता या CIDR रेंज), device_fingerprint, wallet_address, bank_account, country (ISO 3166-1 alpha-3), user या business (आपका vendor_data), या key (कोई भी स्ट्रिंग)। यह तय करता है कि प्रविष्टि मानों को कैसे मान्य और मिलान किया जाता है। बाद में बदला नहीं जा सकता।

उपलब्ध विकल्प:
face,
document,
phone,
email,
ip_address,
device_fingerprint,
wallet_address,
bank_account,
country,
user,
business,
key
description
string
डिफ़ॉल्ट:""

वैकल्पिक फ़्री-टेक्स्ट विवरण।

प्रतिक्रिया

सूची बनाई गई।

एक एप्लिकेशन की ब्लॉकलिस्ट, allowlist या कस्टम सूची।

uuid
string<uuid>
आवश्यक

सूची पहचानकर्ता। इसे सूची और प्रविष्टि endpoint में list_uuid के रूप में, और value_type: "list" के साथ वर्कफ़्लो या लेन-देन नियम शर्त के मान के रूप में उपयोग करें।

name
string
आवश्यक

सूची का नाम, एप्लिकेशन की सूचियों के बीच अद्वितीय।

Maximum string length: 255
description
string
आवश्यक

मुक्त-पाठ विवरण। सेट न होने पर खाली स्ट्रिंग।

list_type
enum<string>
आवश्यक

blocklist: एक मिलान सत्र या लेन-देन को अस्वीकार कर देता है (केवल सिस्टम सूचियां, प्रति प्रविष्टि प्रकार एक)। allowlist: मिलान करने वाले आइटम विश्वसनीय होते हैं, उदाहरण के लिए एक फ़ेस अनुमति सूची डुप्लिकेट-फ़ेस कार्रवाई को छोड़ देती है; कभी भी ब्लॉकलिस्ट मिलान को ओवरराइड नहीं करती। custom: वर्कफ़्लो और लेन-देन नियम शर्तों में उपयोग किया जाता है (value_type: "list")।

उपलब्ध विकल्प:
blocklist,
allowlist,
custom
entry_type
enum<string>
आवश्यक

सूची में क्या समाहित है: face, document (दस्तावेज़ संख्या), phone, email, ip_address (IP पता या CIDR रेंज), device_fingerprint, wallet_address, bank_account, country (ISO 3166-1 alpha-3), user या business (आपका vendor_data), या key (कोई भी स्ट्रिंग)। यह तय करता है कि प्रविष्टि मानों को कैसे मान्य और मिलान किया जाता है।

उपलब्ध विकल्प:
face,
document,
phone,
email,
ip_address,
device_fingerprint,
wallet_address,
bank_account,
country,
user,
business,
key
is_system
boolean
आवश्यक

Didit द्वारा प्रदान की जाने वाली सूचियों के लिए true: प्रत्येक प्रविष्टि प्रकार (face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, user, business) के लिए एक ब्लॉकलिस्ट, High Risk Countries कस्टम सूची, और सिस्टम अनुमत सूचियाँ। सिस्टम सूचियों का नाम बदला, संपादित या हटाया नहीं जा सकता; आप उनकी प्रविष्टियाँ जोड़ और हटा सकते हैं।

entry_count
integer
आवश्यक

वर्तमान में सूची में प्रविष्टियों की संख्या।

आवश्यक सीमा: x >= 0
last_entry_added_at
string<date-time> | null
आवश्यक

नवीनतम वर्तमान प्रविष्टि कब जोड़ी गई थी। खाली सूची के लिए null।

created_at
string<date-time>
आवश्यक

सूची कब बनाई गई थी।

updated_at
string<date-time>
आवश्यक

सूची अंतिम बार कब अपडेट की गई थी।

अंतिम संशोधन 7 नवंबर 2026