डेवलपर

PUT/tcr/v2/brand/{brandId}/revet

मैसेजिंग ब्रांड की पहचान दोबारा सत्यापित करें

मौजूदा व्यवसाय की प्रोफ़ाइल में सुधार करने के बाद अलग शुल्क वाली पहचान जाँच का एक अनुरोध भेजें, फिर उसके परिणाम पर नज़र रखें।

इस पृष्ठ पर
  1. सुधारी गई व्यावसायिक पहचान की दोबारा जाँच करें
  2. सबमिट करने से पहले ब्रांड की समीक्षा करें
  3. अलग से लगने वाले शुल्क की पुष्टि करें
  4. जिस प्रयास का इरादा है, केवल वही सबमिट करें
  5. परिणाम पढ़ें और उसकी स्थिति पर नज़र रखें
  6. अनिश्चित परिणाम का समाधान करें
  7. ग्राहक पोर्टल का उपयोग

सुधारी गई व्यावसायिक पहचान की दोबारा जाँच करें

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

अनुमत स्रोत IP से HTTPS के माध्यम से अपने स्वयं के सक्षम API खाते का उपयोग करें। ब्रांड उसी खाते का होना चाहिए। ब्रांड के रिकॉर्ड गोपनीय रखें: उनमें व्यवसाय और संपर्क संबंधी जानकारी होती है।

सबमिट करने से पहले ब्रांड की समीक्षा करें

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

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

अलग से लगने वाले शुल्क की पुष्टि करें

प्रोडक्शन परिवेश में पुनः सत्यापन के लिए वर्तमान में निर्धारित शुल्क है प्रत्येक स्वीकृत प्रयास के लिए US$5.00, जिसकी जाँच 24 अक्टूबर 2026 को की गई थी। इसमें मानक ब्रांड शुल्क लागू होता है, तब भी जब मूल इकाई का पंजीकरण शुल्क अलग हो। खरीदारी सक्षम होनी चाहिए; प्रीपेड खातों में सबमिट करने से पहले पर्याप्त शेष राशि होनी चाहिए।

202 प्रतिक्रिया का अर्थ है कि अनुरोध आगे की प्रक्रिया के लिए स्वीकार कर लिया गया है और स्वीकार करते समय शुल्क वसूलने की कार्रवाई भेज दी जाती है। इसका अर्थ यह नहीं है कि व्यवसाय सत्यापित हो गया है। बाद में किए गए किसी नए प्रयास पर फिर से शुल्क लग सकता है। केवल सत्यापन लंबित रहने के कारण नया प्रयास न बनाएँ।

जिस प्रयास का इरादा है, केवल वही सबमिट करें

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

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

सार्वजनिक API सक्षम टोकन खाते के लिए Bearer प्रमाणीकरण भी स्वीकार करता है। खाते के स्वामित्व और अनुमत स्रोत IP की जाँचें फिर भी लागू होती हैं। सहेजे गए मॉक ब्रांड प्रोडक्शन शुल्क की इस प्रक्रिया से नहीं गुजरते, लेकिन सैंडबॉक्स का परिणाम प्रोडक्शन में पहचान का सत्यापन नहीं है।

परिणाम पढ़ें और उसकी स्थिति पर नज़र रखें

पुनः सत्यापन की प्रतिक्रियाएँ
प्रतिक्रियाअर्थ और अगला कदम
200अनुरोध सफल हुआ। लौटाए गए ब्रांड की जाँच करें और पहचान की स्थिति की पुष्टि करने के लिए ब्रांड का वर्तमान रिकॉर्ड फिर से पढ़ें।
202स्वीकार कर लिया गया है, आगे का सत्यापन लंबित है। ब्रांड ID सुरक्षित रखें और एक और शुल्क वाला प्रयास सबमिट किए बिना बाद में उसकी वर्तमान स्थिति जाँचें।
400रजिस्ट्री से लौटाई गई त्रुटियों की समीक्षा करें। मूल पंजीकरण लंबित हो सकता है, प्रोफ़ाइल में बदलाव न हुआ हो सकता है या कोई अन्य वैधता जाँच नियम लागू हो सकता है।
401 / 404प्रमाणीकरण विवरण और अनुमत IP की जाँच करें, या खाते के स्वामित्व वाले ब्रांड की ID जाँचें।
402 / 503स्थानीय खरीदारी/खाते में धन उपलब्ध कराने या मूल्य निर्धारण/सेवा संबंधी त्रुटि की समीक्षा करें। यह न मानें कि हर 503 इस बात का प्रमाण है कि अपस्ट्रीम सेवा को कोई अनुरोध नहीं भेजा गया।
429Retry-After के निर्देश का पालन करें और प्रयास के विवरण वही रखें।

बदलाव का अनुरोध स्वीकार होने के बाद प्रॉक्सी ब्रांड का अपना स्थानीय रिकॉर्ड ताज़ा करती है; केवल रिकॉर्ड ताज़ा होना सत्यापन के अंतिम परिणाम का प्रमाण नहीं है। व्यवसाय असत्यापित या लंबित स्थिति में रह सकता है। अभियान की सेटअप प्रक्रिया आगे बढ़ाने से पहले केवल HTTP स्वीकृति पर निर्भर रहने के बजाय ब्रांड की वर्तमान स्थिति देखें।

अनिश्चित परिणाम का समाधान करें

संचार विफल होने पर कैश किया गया 502 मिल सकता है। अपस्ट्रीम सेवा द्वारा अनुरोध स्वीकार किए जाने के बाद स्थानीय रूप से डेटा सहेजने या बिलिंग में विफलता होने पर requestId के साथ कैश किया गया 500 मिल सकता है। उस पहचानकर्ता को सुरक्षित रखें और सहायता टीम के साथ ब्रांड तथा बिलिंग की वर्तमान स्थिति का मिलान करके समाधान करें। दूसरी कुंजी बनाने से अलग से शुल्क लगने वाला प्रयास बन सकता है; बिना स्थिति समझे नई कुंजी से दोबारा कोशिश न करें।

ग्राहक पोर्टल का उपयोग

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

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