मुख्य सामग्री पर जाएं
POST
curl

अवलोकन

एक या अधिक व्यवसाय इकाइयों को हटाता है। व्यवसाय रिकॉर्ड स्थायी रूप से हटा दिए जाते हैं। व्यवसाय सत्यापन (KYB) सत्र इस endpoint से कवर नहीं होते और व्यवसाय से उनका लिंक हटाए जाने के बाद भी बने रहते हैं; उन्हें सत्र हटाएँ से हटाएँ। लेन-देन भी इसमें कवर नहीं होते; उन्हें बैच में लेन-देन हटाएँ से हटाएँ।

कब उपयोग करें

  • भूल जाने का अधिकार संबंधी अनुरोध।
  • QA के दौरान परीक्षण व्यवसायों की साफ़-सफ़ाई।
  • आपके अपने प्लेटफ़ॉर्म से हटाए गए व्यवसायों का डीप्रोविज़निंग।

नोट्स

  • vendor_data मानों या didit_internal_id मानों की सूची स्वीकार करता है।
  • आइडेम्पोटेंसी है: पहले से हटाए जा चुके व्यवसाय को हटाने से कोई बदलाव नहीं होता।
  • केवल हटाई गई चीज़ों की संख्या लौटाता है, प्रति-आइटम रिपोर्ट नहीं। जिन मानों से कोई मिलान नहीं हुआ, उन्हें बिना सूचना के छोड़ दिया जाता है।
  • deleted_at सेट के साथ business.data.updated इवेंट जारी करता है।
  • व्यवसाय इकाई के अपने रिकॉर्ड उसके साथ ही हटा दिए जाते हैं: उसके टैग लिंक, उसका टिप्पणी इतिहास, और उसके अपने डिवाइस और नेटवर्क रिकॉर्ड।
  • व्यवसाय सत्यापन (KYB) सत्र द्वारा बनाए गए रिकॉर्ड इसमें बिल्कुल नहीं हटते: कंपनी रजिस्ट्री डेटा, अपलोड किए गए दस्तावेज़, AML हिट, वास्तविक स्वामी और प्रमुख व्यक्तियों की जाँच, ये सभी सत्र से जुड़े हैं और जब तक आप सत्र को स्वयं नहीं हटाते, तब तक बने रहते हैं।

अंतिम विनियामक रिपोर्ट वाला डेटा

यदि चुनी गई कोई भी कंपनी ऐसे केस का हिस्सा है जिसमें अंतिम विनियामक रिपोर्ट है, तो पूरा अनुरोध 409 लौटाता है और कुछ भी नहीं हटाया जाता। प्रतिक्रिया code: in_filed_report का उपयोग करती है और हर रिपोर्ट का नाम बताती है:
रिपोर्ट हटाएँ से हर रिपोर्ट हटाएँ, फिर वही अनुरोध दोहराएँ।

पहले से चल रही हटाने की प्रक्रिया

किसी कंपनी को एक समय में एक ही अनुरोध से हटाया जाता है। यदि कोई दूसरा अनुरोध अभी भी चुनी गई किसी कंपनी को हटा रहा है, तो यह अनुरोध अधिकतम कुछ सेकंड प्रतीक्षा करता है, फिर code: subject_deletion_in_progress के साथ 409 लौटाता है और कुछ भी नहीं हटाता:
दूसरी हटाने की प्रक्रिया पूरी होने के बाद वही अनुरोध दोहराएँ। जिस कंपनी को यह अनुरोध पहले ही हटा चुका है, वह अब मेल नहीं खाती, इसलिए दोहराया गया अनुरोध केवल बची हुई कंपनियों को हटाता है।

अनुमतियाँ

भूमिका में delete:businesses की अनुमति होनी चाहिए। आम तौर पर यह OWNER और ADMIN भूमिकाओं के लिए आरक्षित होती है।

संबंधित

प्राधिकरण

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

vendor_data_list, didit_internal_id_list, या delete_all: true प्रदान करें। जब कई भेजे जाते हैं तो प्राथमिकता: delete_all > vendor_data_list > didit_internal_id_list (केवल उच्चतम-प्राथमिकता वाले चयनकर्ता का उपयोग किया जाता है)।

vendor_data_list
string[]

हटाने के लिए आपके अपने पहचानकर्ता, ठीक वैसे ही मिलान किए जाते हैं जैसे भेजे गए थे।

didit_internal_id_list
string<uuid>[]

हटाने के लिए Didit के आंतरिक UUIDs (didit_internal_id)।

delete_all
boolean
डिफ़ॉल्ट:false

यदि true है, तो एप्लिकेशन में प्रत्येक व्यवसाय को हटा देता है। सूची चयनकर्ताओं के साथ संयोजित नहीं किया जा सकता है।

प्रतिक्रिया

व्यवसाय हटा दिए गए। वास्तव में हटाई गई पंक्तियों की संख्या लौटाता है।

deleted
integer

हटाए गए व्यवसायों की संख्या (उन vendor_data मानों को छोड़ता है जो किसी चीज़ से मेल नहीं खाते थे)।

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