किसी एक्सचेंज के लिए मोबाइल इन्वेंटरी जाँचें

एक समर्थित प्रीफिक्स चुनें

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

गिनती को संकेत के रूप में उपयोग करें

पढ़ें response.count, जिसमें response.npa और response.nxx एक्सचेंज की पहचान करते हैं। यह कवरेज सेवा का स्नैपशॉट है, न कि आपके खाते के लिए आरक्षित स्टॉक। ऑर्डर करने से पहले वास्तविक नंबरों, लागू कोटेशनों और पंजीकरण की किसी भी आवश्यकता की पुष्टि करें। सफल गिनती कभी भी खरीद को अधिकृत नहीं करती।

शून्य स्टॉक और विफल लुकअप में अंतर करें

शून्य की सफल गिनती API त्रुटि से भिन्न है। निरीक्षण करें status.code और status.msg के साथ-साथ HTTP स्थिति भी। टाइमआउट या विफल लुकअप को अज्ञात उपलब्धता मानें और बाद में बैकऑफ के साथ पुनः प्रयास करें।

अनुरोध

HTTPS के माध्यम से अपने सक्षम API खाते के क्रेडेंशियल का उपयोग करें। Basic प्रमाणीकरण और सक्षम API-खाते के बेयरर टोकन समर्थित हैं; खाता प्रतिबंध लागू होते हैं।

URL पथ में प्रीफिक्स पहचानकर्ता के साथ GET। कोई दस्तावेज़ित क्वेरी या बॉडी पैरामीटर नहीं हैं।

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

प्रतिक्रिया

JSON बॉडी में status.code की जाँच करें, साथ ही HTTP स्थिति भी। एक सफल response में status.code 200 और status.msg Results होता है। response एक ऑब्जेक्ट है, सूची नहीं: count एक पूर्णांक इन्वेंटरी स्नैपशॉट है; npa और nxx तीन-वर्ण वाली स्ट्रिंग हैं। status.results इस संबद्ध ऑब्जेक्ट के लिए मौजूद नहीं है। 0 की गिनती का अर्थ है कि कवरेज लुकअप का कोई मेल खाता एक्सचेंज नहीं था या उसने शून्य स्टॉक लौटाया; यह यह सिद्ध नहीं करता कि सभी आपूर्तिकर्ताओं या अन्य डिस्कवरी मार्गों के पास कोई नंबर नहीं हैं।

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

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

त्रुटियाँ

• 404: प्रदाता अक्षम: सेवा पर मोबाइल इन्वेंटरी कवरेज अनुपलब्ध है।
• 404: अमान्य प्रीफिक्स ID: डिस्कवरी से एक वर्तमान एकल प्रीफिक्स ID प्राप्त करें।
• 404: अमान्य प्रीफिक्स: संग्रहीत प्रीफिक्स में NPA/NXX लुकअप के लिए पर्याप्त अंक नहीं हैं।
• 500: इन्वेंटरी कवरेज विफल: अपस्ट्रीम लुकअप ने सफल कवरेज परिणाम नहीं लौटाया। बाद में बैकऑफ के साथ पुनः प्रयास करें; विफलता शून्य स्टॉक गिनती नहीं है।

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

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