ब्रांड की जाँच के नतीजे देखें

वह ब्रांड चुनें जिसकी जाँच आप कर रहे हैं

अपने खाते का ब्रांड पहचानकर्ता इस्तेमाल करें। इसे जाँच से मिले रिकॉर्ड के साथ रखें, ताकि एक व्यवसाय की समीक्षा को दूसरे व्यवसाय की समीक्षा न समझ लिया जाए। किसी दूसरे खाते के पहचानकर्ताओं का इस्तेमाल न करें।

मौजूदा समीक्षा की प्रगति देखें

सहेजकर रखें: vettingId, evpId, vettingClass और vettingStatus (यदि उपलब्ध हों)। वर्तमान समन्वयन प्रक्रिया PENDING और UNSCORE को ऐसे नतीजे मानती है जिनकी आगे जाँच अभी बाकी है, और ACTIVE और FAILED को शुल्क निपटान के लिए अंतिम नतीजे मानती है। आगे कोई कार्रवाई ज़रूरी है या नहीं, यह तय करने से पहले लौटाए गए विवरण पढ़ें। केवल खाली सूची मिलना इस बात का प्रमाण नहीं है कि पहले भेजा गया अनुरोध रजिस्ट्री तक नहीं पहुँचा था।

पहले दिए गए ऑर्डर के शुल्क समझें

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

दूसरा ऑर्डर दिए बिना जानकारी पढ़ने का फिर प्रयास करें

अस्थायी विफलता की स्थिति में ब्रांड और जाँच के ज्ञात पहचानकर्ता सुरक्षित रखें, पालन करें: Retry-After और प्रयासों के बीच बढ़ते अंतराल के साथ यह जानकारी फिर पढ़ने का प्रयास करें। केवल इसलिए नई समीक्षा का ऑर्डर न दें कि स्थिति की खोज विफल हो गई या उत्तर का मुख्य भाग अपेक्षा से अलग मिला। यदि विसंगति बनी रहे, तो प्रमाणित सहायता चैनल के माध्यम से संबंधित संदर्भ पहचानकर्ताओं के साथ MultiTEL से संपर्क करें।

पंजीकरण के चरण अलग रखें

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

अनुरोध

अनुमत स्रोत आईपी पते से HTTPS के माध्यम से ऐसे खाते का उपयोग करें जिसमें API सक्षम हो। अपने खाते के प्रमाणीकरण विवरण इस्तेमाल करें, रजिस्ट्री के प्रमाणीकरण विवरण नहीं। ब्रांड का संबंध प्रमाणित खाते से होना अनिवार्य है।

GET अनुरोध में ब्रांड पहचानकर्ता पथ में और अनिवार्य vettingStatus फ़िल्टर क्वेरी में दें। समीक्षा किए गए स्कीमा में स्थितियों की एक सरणी परिभाषित है; यह उदाहरण एक ACTIVE मान का अनुरोध करता है। यह मार्गदर्शिका बहु-मान एन्कोडिंग या प्रदाता द्वारा बिना फ़िल्टर वाले अनुरोध स्वीकार किए जाने की पुष्टि नहीं करती। अनुरोध का मुख्य भाग आवश्यक नहीं है।

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

उत्तर

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

उत्तर की संरचना का उदाहरण; यह खाते का वास्तविक समय का डेटा या वर्तमान मूल्य प्रस्ताव नहीं है।

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

त्रुटियाँ

• 401: खाते का प्रमाणीकरण विफल हुआ। प्रमाणीकरण विवरण, API सक्षम होने की स्थिति और स्रोत आईपी पर लागू प्रतिबंध जाँचें।
• 404: ब्रांड इस खाते से जुड़ा नहीं है या रजिस्ट्री उसे नहीं ढूँढ सकी। खाते के स्वामित्व के आधार पर अस्वीकृति रजिस्ट्री को अनुरोध भेजने से पहले होती है।
• 429: खाते या रजिस्ट्री की अनुरोध सीमा पूरी हो गई है। Retry-After का पालन करें और प्रयासों के बीच बढ़ता अंतराल रखें।
• 502/503: डेटा संचार, रजिस्ट्री, अनुरोध सीमित करने वाला घटक या स्थानीय प्रसंस्करण उपलब्ध नहीं है। किसी त्रुटि से यह सिद्ध नहीं होता कि पहले किया गया समीक्षा अनुरोध विफल हुआ था।

उपलब्धता और अतिरिक्त प्रभाव

• यह GET जाँच का नया ऑर्डर नहीं देता। यह रजिस्ट्री से नतीजे प्राप्त करता है, अनुरोध के लेखापरीक्षा रिकॉर्ड लिखता है और संग्रहित नतीजों का समन्वयन करता है।
• पूरी हो चुकी समीक्षा का नतीजा पढ़ने से किसी पहले से दिए गए शुल्क योग्य जाँच ऑर्डर का शुल्क निपटाया जा सकता है। विफल समीक्षा पर लागू विफलता शुल्क लग सकता है। ऑर्डर देते समय कीमत और शर्तें देखें; जानकारी पढ़ने का यह अनुरोध मूल्य प्रस्ताव नहीं है।
• इस GET द्वारा आयात किए गए नए मिले रिकॉर्ड को अपने-आप नया शुल्क योग्य ऑर्डर नहीं माना जाता।
• सफल या ACTIVE जाँच नतीजे का अर्थ अभियान की स्वीकृति, फ़ोन नंबर का आवंटन या संदेश भेजने की अनुमति नहीं है।