डेवलपर

GET/v3/getpriceinfo/{visible_uuid}

सहेजी गई नंबर मूल्य योजना पढ़ें

खाता-विशिष्ट सहेजी गई मूल्य-निर्धारण जानकारी प्राप्त करें और ऑर्डर करने से पहले पुराने, खाली या अस्पष्ट परिणामों को संभालें।

इस पृष्ठ पर
  1. सहेजी गई मूल्य योजना पढ़ें
  2. अनुरोध
  3. प्रतिक्रिया
  4. मूल्य फ़ील्ड
  5. एकाधिक मेल खाने वाली पंक्तियों को संभालें
  6. खाली प्रतिक्रियाएँ और त्रुटियाँ
  7. प्रभाव और सीमाएँ

सहेजी गई मूल्य योजना पढ़ें

उपलब्ध फ़ोन नंबर ब्राउज़ करने के बाद अपने API खाते के लिए सहेजी गई मूल्य पंक्तियाँ देखें। मूल्य विकल्प का uuid उपयोग करें, जो चयनित नंबर की price सूची से लिया गया हो, न कि उसका नंबर, प्रीफ़िक्स ID या एरिया ID। चयनित नंबर और मूल्य विकल्प को एक साथ रखें।

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

अनुरोध

किसी अनुमत IP पते से HTTPS पर अपने सक्षम API खाते का उपयोग करें। PRICE_ID को ठीक उसी मूल्य विकल्प ID पर सेट करें जो आपको प्राप्त हुई थी। यह मेथड एक पाथ आर्ग्युमेंट पढ़ता है और कोई बॉडी, दिनांक या पेजिनेशन पैरामीटर नहीं पढ़ता।

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"

यह लुकअप उसी खाते से किया जाना चाहिए जिसने मूल्य विकल्प प्राप्त किया था। कोई ID स्वयं न बनाएँ, डेटाबेस पंक्ति संख्या का उपयोग न करें, और न ही किसी अन्य खाते के चयन को प्रतिस्थापित करें। यह लेगेसी मेथड केवल दृश्यमान मूल्य ID का मिलान करता है।

प्रतिक्रिया

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "visible_uuid": "PRICE_FROM_SEARCH",
      "setup_price": "2.00",
      "monthly_price": "4.50",
      "per_minute": "0.0100",
      "free_minutes": "100",
      "channels": "2"
    }
  ]
}

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

मूल्य फ़ील्ड

चुने हुए मूल्य-योजना फ़ील्ड
फ़ील्डअर्थ
visible_uuidसहेजे गए मूल्य विकल्प का दृश्यमान पहचानकर्ता। लुकअप का मिलान करते समय मूल विकल्प ID का उपयोग करें।
setup_priceइस विकल्प के लिए संग्रहीत एकमुश्त सेटअप मूल्य।
monthly_priceसंग्रहीत आवर्ती मासिक मूल्य।
per_minute, free_minutesसंग्रहीत आने वाली कॉल की प्रति-मिनट दर और शामिल मिनटों की मात्रा। ये आउटगोइंग कॉल या हर संभावित अधिभार का उद्धरण नहीं देते।
channelsइस विकल्प के लिए संग्रहीत चैनल मात्रा; यह लाइव क्षमता या पंजीकरण की जाँच नहीं है।
yearly_priceएक अतिरिक्त संग्रहीत वार्षिक-मूल्य फ़ील्ड मौजूद हो सकता है। यह अनुमान न लगाएँ कि एक शून्येतर मासिक मूल्य और शून्य वार्षिक फ़ील्ड मिलकर एक निःशुल्क वार्षिक योजना दर्शाते हैं।

एकाधिक मेल खाने वाली पंक्तियों को संभालें

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

पोर्टल का ऑर्डर-समीक्षा वर्कफ़्लो अतिरिक्त चयन और वैधता जाँचें करता है। यह न मानें कि यह लेगेसी लुकअप वे जाँचें लागू करता है या हर उस पहचानकर्ता को स्वीकार करता है जिसे पोर्टल स्वीकार करता है।

खाली प्रतिक्रियाएँ और त्रुटियाँ

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

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

प्रभाव और सीमाएँ

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