किसी अप्रयुक्त अपलोड संदर्भ को हटाएँ

कोई अप्रयुक्त अपलोड संदर्भ चुनें

यह एंडपॉइंट आपके खाते से संबंधित अपलोड संदर्भ रिकॉर्ड को हटाता है। इसका उपयोग केवल तब करें जब आपको पक्का पता हो कि संदर्भ अब इनमें से किसी काम के लिए आवश्यक नहीं है: प्रमाण संलग्न करना या सहायक दस्तावेज़ संलग्न करना। यह पंजीकरण से जुड़ी पहचान या पता नहीं हटाता है।

बाहरी फ़ाइल आईडी प्राप्त करने के लिए मूल अपलोड का उत्तर या उपलब्ध अपलोड की सूची का उपयोग करें। हैंडलर पहले आपके खाते के लिए उस आईडी को खोजता है; न मिलने पर पुराने प्रदाता आईडी के आधार पर खोज करता है। नए एकीकरणों में बाहरी संदर्भ का ठीक उसी रूप में उपयोग करना चाहिए जिस रूप में वह लौटाया गया है। अनुरोध की बॉडी आवश्यक नहीं है।

सोच-समझकर हटाने का अनुरोध करें

किसी सक्षम MultiTEL API खाते के लिए कॉन्फ़िगर किए गए क्रेडेंशियल और आईपी प्रतिबंधों का पालन करते हुए HTTPS के ज़रिए उसका उपयोग करें। POST का उपयोग करें ताकि आपका अनुप्रयोग इसे जानबूझकर किया जाने वाला बदलाव माने:

curl --silent --show-error --request POST \
  --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdef

वर्तमान हैंडलर HTTP विधि पर कोई प्रतिबंध लागू नहीं करता है: GET अनुरोध भी हटाने की कार्रवाई तक पहुँच सकता है। इस यूआरएल को सामान्य क्लिक करने योग्य लिंक, चित्र, बुकमार्क, पूर्वावलोकन या पहले से फ़ेच करने के लक्ष्य के रूप में उपलब्ध न कराएँ। अपने अनुप्रयोग में हटाने के लिए स्पष्ट कार्रवाई अनिवार्य करें और अपने-आप दोबारा प्रयास न करें।

परिणाम और उसकी सीमाएँ समझें

HTTP परिणाम और JSON में status.code, दोनों पढ़ें। सफलता मिलने पर सामान्य उत्तर यह होता है:

{
  "status": {"code": 200, "msg": "Success"},
  "response": []
}

API कोड 404 के साथ Failed, Not found का अर्थ है कि दोनों में से किसी भी खोज में इस खाते का कोई मेल खाता संदर्भ नहीं मिला। इसलिए दोबारा हटाने का अनुरोध करने पर 404 लौट सकता है। पथ के मान के शुरू और अंत में मौजूद रिक्त स्थान हटा दिए जाते हैं। यहाँ यह जाँच नहीं की जाती कि संदर्भ की वैधता अभी बाकी है या कोई अन्य चरण उसका उपयोग नहीं कर रहा है, इसलिए उसे हटाने से पहले अपने कार्यप्रवाह की पुष्टि करें।

हैंडलर डेटाबेस से हटाने का प्रयास करने के बाद सफलता की सूचना देता है, लेकिन यह नहीं जाँचता कि हटाने की कार्रवाई सफल हुई या नहीं। उत्तर को केवल बताया गया परिणाम मानें, मिटाए जाने का स्वतंत्र प्रमाण नहीं। यदि API से बनाया गया कोई संदर्भ, जिसकी वैधता अभी बाकी थी, get_encrypted_files में दिखाई दे रहा था, तो उस सूची से यह जाँचने में मदद मिल सकती है कि वह अभी भी दिखाई देता है या नहीं; लेकिन सूची में उसका न होना उसकी वैधता समाप्त होने का संकेत भी हो सकता है।

हटाने का अर्थ डेटा को पूरी तरह मिटाना नहीं है

हैंडलर अपलोड संदर्भ तालिका से हटाने का निर्देश देता है। यह संग्रहीत दस्तावेज़ सामग्री वाली पंक्ति, स्थानीय अपलोड की गई फ़ाइल, संलग्न प्रमाण, पहचान, सहायक दस्तावेज़ या प्रदाता के पास मौजूद प्रति को स्पष्ट रूप से नहीं हटाता है। डेटाबेस में संबंधित रिकॉर्ड पर क्रमिक प्रभाव और डेटा बनाए रखने के व्यवहार की पुष्टि नहीं हुई है। उपयोगकर्ताओं को यह न बताएँ कि इस कार्रवाई से उनके पहचान दस्तावेज़ की सभी प्रतियाँ मिट जाती हैं या डेटा पूरी तरह मिटाने का अनुरोध पूरा हो जाता है।

स्थानीय संदर्भ हट जाने के बाद, आगे के वे संलग्न करने वाले चरण विफल हो सकते हैं जिन्हें उसकी आवश्यकता है। पहले ही पूरे हो चुके संलग्न करने के चरणों के परिणाम सुरक्षित रखें और जमा की गई पंजीकरण जानकारी बदलते समय संबंधित पहचान या प्रमाण प्रबंधन कार्यप्रवाह का उपयोग करें।