उपलब्ध मोबाइल नंबर खोजें

पुष्टि करें कि मोबाइल इन्वेंटरी सक्षम है

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

वर्तमान लेगेसी रूट हर अपात्र अनुरोध को विश्वसनीय रूप से अस्वीकार नहीं करता। जिस खाते में मोबाइल इन्वेंटरी सक्षम नहीं है, उसे सामान्य इन्वेंटरी मिल सकती है, जबकि प्रतिक्रिया में अब भी info.is_mobile: 1 लिखा होता है। टोल-फ़्री प्रीफ़िक्स भी इसी लेबल के साथ टोल-फ़्री इन्वेंटरी शाखा तक पहुँच सकता है। मोबाइल सेवा की पहचान के लिए केवल इस लेबल का उपयोग न करें, और इस एंडपॉइंट पर सामान्य या टोल-फ़्री प्रीफ़िक्स न भेजें। खाते के पुष्ट मोबाइल कैटलॉग और सक्षम वर्कफ़्लो का उपयोग करें।

प्रत्येक नंबर को उसके अपने मूल्य चयन के साथ रखें

प्रत्येक उम्मीदवार के लिए, number, info.uuid और उसी प्रविष्टि की price सूची को एक साथ रखें। प्रतिक्रिया में प्रीफ़िक्स/क्षेत्र/देश मेटाडेटा, अनुबंध की शर्तें और पंजीकरण प्रतिबंध भी होते हैं। उम्मीदवारों को उनके पहले मूल्य विकल्प के मासिक मूल्य के अनुसार आरोही क्रम में क्रमबद्ध किया जाता है; समान मूल्यों के लिए कोई स्थिर क्रम सुनिश्चित नहीं है। लौटाए गए नंबर ID को किसी क्षेत्र या प्रीफ़िक्स ID से न बदलें, और न ही उसे किसी अन्य उम्मीदवार के मूल्य ID के साथ जोड़ें।

पूर्ण प्रतिक्रिया में अतिरिक्त मेटाडेटा और मूल्य फ़ील्ड शामिल हो सकते हैं। लौटाए गए features, चैनल मान और restrictions उम्मीदवार का वर्णन करते हैं; वे इस बात की गारंटी नहीं हैं कि कॉल, SMS, MMS या फ़ैक्स पहले से उपयोग योग्य हैं। खाता अनुमतियाँ, पंजीकरण और चयनित सेवा योजना अब भी लागू होती हैं। उदाहरण के प्लेसहोल्डर को मान्य ID या मूल्य न मानें।

एक छोटी धनात्मक मात्रा का उपयोग करें

1 की मात्रा से शुरू करें। सामान्य प्रदाता अनुरोध गैर-धनात्मक मात्रा को 1 में सामान्यीकृत करता है और अपस्ट्रीम मान को 300 तक सीमित करता है, लेकिन बाद की परिणाम प्रक्रिया अब भी मूल इनपुट का उपयोग करती है। इसलिए शून्य मात्रा अपस्ट्रीम इन्वेंटरी का अनुरोध कर सकती है और कोई उम्मीदवार नहीं लौटा सकती। अन्य लेगेसी शाखाएँ अनुरोधित परिणाम संख्या को लगातार लागू नहीं करतीं। किसी एक सार्वभौमिक अधिकतम पर भरोसा न करें और ऋणात्मक, भिन्नात्मक या गैर-संख्यात्मक मान न भेजें। इस रूट के लिए कोई समर्थित सार्वजनिक खोज फ़िल्टर या मूल्य-ID बॉडी पैरामीटर प्रलेखित नहीं है।

स्टॉक की कमी और लुकअप विफलता में अंतर करें

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

खरीदने से पहले पुनः जाँच करें

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

अनुरोध

अनुमत स्रोत IP पते से HTTPS पर सक्षम API खाते का उपयोग करें। ग्राहक खाते के लिए मोबाइल इन्वेंटरी भी सक्षम होनी चाहिए; केवल API प्रमाणीकरण इसे सक्षम नहीं करता।

URL पथ में वर्तमान एकल प्रीफ़िक्स पहचानकर्ता और धनात्मक पूर्ण-संख्या मात्रा के साथ GET करें। छोड़े जाने पर मात्रा डिफ़ॉल्ट रूप से 1 होती है। उदाहरण का उपयोग 1 के साथ करें; यह रूट किसी सार्वभौमिक परिणाम सीमा को लगातार मान्य या लागू नहीं करता।

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"

प्रतिक्रिया

HTTP स्थिति के साथ-साथ JSON बॉडी में status.code और status.msg की जाँच करें। सफलता पर, response नंबर उम्मीदवारों की सूची होती है, status.msg में Results: के बाद लौटाई गई संख्या होती है, और status.results सीरियलाइज़ की गई सूची की लंबाई होती है। उम्मीदवार मूल्य खाता-विशिष्ट होते हैं। उदाहरणात्मक संक्षिप्त उदाहरण वास्तविक इन्वेंटरी या टैरिफ़ के मूल्य-प्रस्ताव के बजाय प्लेसहोल्डर का उपयोग करता है। नंबरों में देश कोड बिना प्लस चिह्न के होता है; पहचानकर्ता अपारदर्शी स्ट्रिंग हैं।

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

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

त्रुटियाँ

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

उपलब्धता और साइड इफ़ेक्ट

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