मैसेजिंग ब्रांड का उपयोग समाप्त करें

उपयोग समाप्त करने की कार्यप्रणाली चुनें

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

सार्वजनिक ब्रांड DELETE कॉल और पोर्टल की ‘ब्रांड हटाएँ’ कार्रवाई का दायरा अलग है। सार्वजनिक कॉल रजिस्ट्री से एक ब्रांड हटाती है। पोर्टल ब्रांड हटाने का प्रयास करने से पहले नंबरों को अलग करने और अभियानों को निष्क्रिय करने के कार्यों का समन्वय करता है।

पोर्टल में प्रभाव की समीक्षा करें

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

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

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

सीधे API से हटाने की तैयारी करें

अनुमत स्रोत आईपी पते से HTTPS के माध्यम से सक्षम API खाते का उपयोग करें। ब्रांड उसी खाते का होना चाहिए। उसकी पहचान संख्या और वर्तमान स्थिति पढ़ें और सुरक्षित रखें, फिर उसके अभियानों और नंबर आवंटनों की जाँच करें। ब्रांड हटाने से पहले प्रभावित नंबरों को अलग करें और अभियान निष्क्रिय करें। इस DELETE को ऐसी कार्रवाई न समझें जो संबंधित सभी संसाधनों को भी क्रमशः हटा दे।

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

समीक्षा किए गए ब्रांड को हटाएँ

ब्रांड की पहचान संख्या जाँचने और ऊपर बताए गए सफ़ाई कार्य पूरे करने के बाद ही, जिस ब्रांड का उपयोग समाप्त करना है उसके लिए निम्नलिखित चलाएँ। अनुरोध में कोई JSON बॉडी नहीं है।

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request DELETE \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

दस्तावेज़ के अनुसार सफल परिणाम HTTP 204 है, जिसमें कोई प्रतिक्रिया बॉडी नहीं होती। JSON सफलता ऑब्जेक्ट या पुराने v3 के status/response आवरण की अपेक्षा न करें। अस्वीकृत, गैर-2xx परिणाम वर्तमान API समन्वयन प्रक्रिया के माध्यम से ब्रांड को हटाया गया चिह्नित नहीं करता।

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

उपयोग समाप्त होने की पुष्टि करें और आंशिक परिणामों की विसंगतियाँ दूर करें

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

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

HTTP 400 के लिए रजिस्ट्री की विस्तृत त्रुटि पढ़ें, विशेष रूप से सक्रिय अभियान से संबंधित प्रतिबंध। 401, 403 या 404 के लिए प्रमाणीकरण विवरण, अनुमत स्रोत आईपी और खाते के स्वामित्व की जाँच करें। 429 के लिए Retry-After का पालन करें। बाहरी बदलाव पूरा हो जाने के बाद भी समय समाप्त होने की त्रुटि, 500 या 502 आ सकती है; अनुरोध दोहराने से पहले मौजूदा पंजीकरण की जाँच करें।

खाते पर शेष शुल्कों की जाँच करें

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