ब्रांड की बाहरी जाँच का ऑर्डर दें

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

अनुमत स्रोत आईपी पते से HTTPS के माध्यम से सक्षम API खाते का उपयोग करें। Basic और Bearer प्रमाणीकरण समर्थित हैं। ब्रांड की पहचान संख्या उसी खाते की होनी चाहिए। प्रदाता के टोकन, ब्रांड की पहचान संबंधी डेटा और प्राप्त रिपोर्टों को गोपनीय रखें।

नई बाहरी जाँच का ऑर्डर दें

जब इस ब्रांड के लिए जाँच प्रदाता से नई जाँच करवानी हो, तो POST का उपयोग करें। यदि आपके पास पहले से प्रदाता का परिणाम है, तो इसके बजाय आयात का उपयोग करें। यह अलग प्रक्रिया है: ब्रांड की पहचान का पुनः सत्यापन।

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

प्रदाता के लिए अनुरोध तैयार करें

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

सफलता और विफलता पर लगने वाले शुल्कों की पुष्टि करें

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

बाहरी जाँच के परिणामों के लिए निर्धारित शुल्क
श्रेणी	सक्रिय परिणाम	विफल परिणाम
STANDARD	$46.12	$5.56
ENHANCED	$112.78	$6.67
POLITICAL	$73.34	$24.45
Express अनुरोध के साथ POLITICAL	$106.67	$24.45
AUTHPLUS	$13.89	$13.89
RCS	$83.34	$83.34

लंबित ऑर्डरों के लिए सफलता/विफलता की राशियाँ सुरक्षित रहती हैं और ACTIVE या FAILED परिणाम समन्वयित होने पर उनका निपटान होता है। अंतिम दो श्रेणियों में दोनों अंतिम परिणामों के लिए एक ही निर्धारित शुल्क लगता है। तुरंत अंतिम परिणाम मिलने पर ऑर्डर के उत्तर के दौरान ही शुल्क लिया जा सकता है। बाद में स्थिति के समन्वयन से लंबित शुल्क का निपटान हो सकता है।

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

एक समीक्षित ऑर्डर जमा करें

प्रदाता की पहचान संख्या, श्रेणी और आवश्यक अतिरिक्त जानकारी के साथ vetting-order.json तैयार करें। इस फ़ाइल में वास्तव में भेजा जाने वाला अनुरोध होता है। इसे गोपनीय रखें।

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request POST \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @vetting-order.json \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"

वास्तविक परिणाम पर नज़र रखें

सफल HTTP उत्तर में लंबित जाँच का रिकॉर्ड हो सकता है। उसका vettingId सुरक्षित रखें और उपलब्ध होने पर vettingStatus, कारण, स्कोर तथा प्रभावी होने/समाप्त होने की तारीखें देखें। PENDING और UNSCORE के लिए आगे भी जाँच करते रहना आवश्यक है; ACTIVE, FAILED और EXPIRED अलग-अलग परिणाम दर्शाते हैं। केवल HTTP स्तर पर स्वीकृति मिलना अनुकूल स्कोर या अभियान की पात्रता का प्रमाण नहीं है।

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

उसी इच्छित अनुरोध का पुनः प्रयास करें

हर इच्छित कार्रवाई के लिए एक Idempotency-Key का उपयोग करें और विधि, पथ, क्वेरी तथा अनुरोध के मुख्य भाग के बाइट हूबहू सुरक्षित रखें। कुंजियों में बिना स्पेस के 1–128 मुद्रण योग्य ASCII वर्ण हो सकते हैं। पहले से चल रही कार्रवाई का डुप्लिकेट अनुरोध Retry-After के साथ 409 लौटा सकता है। पूर्ण हो चुके अनुरोधों के लिए त्रुटियों सहित उनका संग्रहीत उत्तर दोबारा लौटाया जाता है। अनुरोध दर की सीमाओं का पालन करें।

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