मुख्य सामग्री पर जाएं
POST
curl
एक कॉल में कई टेम्पलेट पर्ज करता है। या तो स्पष्ट आईडी सूची दें या delete_all: true, जिसे वैकल्पिक रूप से उन्हीं फ़िल्टर से सीमित किया जा सकता है जो List Biometric Templates में हैं।

अनुरोध बॉडी

बिना फ़िल्टर के delete_all: true एप्लिकेशन के हर बायोमेट्रिक टेम्पलेट को पर्ज कर देता है, और इसे वापस नहीं लिया जा सकता। पर्ज होने वाली चीज़ों की पुष्टि के लिए पहले उन्हीं फ़िल्टर के साथ Count Biometric Templates चलाएँ।

उदाहरण

टेम्पलेट एक-एक करके पर्ज किए जाते हैं; हर परिणाम purged या already_purged दर्ज करता है। यदि कोई बायोमेट्रिक स्टोर उपलब्ध नहीं है, तो पहले विफल टेम्पलेट पर कॉल 503 लौटाती है; उसी अनुरोध में पहले पर्ज किए गए टेम्पलेट पर्ज ही रहते हैं, और विफल टेम्पलेट purge_failed पर चला जाता है (मिलान से बाहर रखा जाता है)। अनुरोध दोबारा भेजने पर काम पूरा हो जाता है।

त्रुटियाँ

प्राधिकरण

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
template_uuids
string<uuid>[]

पर्ज किए जाने वाले टेम्पलेट। तब तक आवश्यक है जब तक delete_all का मान true न हो। पहले से पर्ज की गई ID को already_purged के रूप में रिपोर्ट किया जाता है।

Minimum array length: 1
delete_all
boolean
डिफ़ॉल्ट:false

जब true होता है, तो नीचे दिए गए फ़िल्टर से मेल खाने वाले प्रत्येक टेम्पलेट को हटा देता है (कोई फ़िल्टर न दिए जाने पर एप्लिकेशन के सभी टेम्पलेट)। template_uuids को अनदेखा कर दिया जाता है। अपरिवर्तनीय।

vendor_data
string

केवल delete_all के साथ: स्वामित्व वाले उपयोगकर्ता के vendor_data पर केस-इंसेंसिटिव सबस्ट्रिंग मिलान।

vendor_user_uuid
string<uuid>

केवल delete_all के साथ: स्वामित्व वाले उपयोगकर्ता पर सटीक मिलान।

status
enum<string>

केवल delete_all के साथ।

उपलब्ध विकल्प:
pending,
active,
expired,
held_out_of_use,
purge_pending,
purge_failed
source_type
enum<string>

केवल delete_all के साथ।

उपलब्ध विकल्प:
session_delete,
automatic_retention,
backfill
retained_from
string<date-time>

केवल delete_all के साथ।

retained_to
string<date-time>

केवल delete_all के साथ। retained_from से पहले का नहीं होना चाहिए।

प्रतिक्रिया

प्रति-टेम्पलेट पर्ज परिणाम।

results
object[]
अंतिम संशोधन 7 नवंबर 2026