डेवलपर

GET/v3/nanpacheck/{number}

उत्तर अमेरिकी आवंटन का कवरेज जाँचें

किसी नंबर का आवंटन तालिका से मिलान करें; इसे ग्राहक या नंबर की उपलब्धता का सत्यापन न मानें।

इस पृष्ठ पर
  1. आवंटन तालिका का कवरेज जाँचें
  2. अनुरोध
  3. प्रतिक्रिया
  4. त्रुटियाँ
  5. लागत और अगले चरण

आवंटन तालिका का कवरेज जाँचें

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

अनुरोध

अपने सक्षम किए गए API खाते और अनुमत स्रोत IP पते का उपयोग करें। उदाहरण में परिवेश चरों से लिए गए HTTP Basic क्रेडेंशियल और एक काल्पनिक नंबर का उपयोग किया गया है। अनुरोध की बॉडी आवश्यक नहीं है।

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

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

प्रतिक्रिया

फ़ील्ड के मान केवल उदाहरण के लिए हैं; यह लाइव आवंटन तालिका से प्राप्त परिणाम नहीं है।

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}
आवंटन मिलान के फ़ील्ड
फ़ील्डअर्थ
numberमानकीकृत इनपुट, जिसमें केवल अंक हैं।
npanxxमेल खाने वाला संग्रहित उपसर्ग। हैंडलर सात अंकों के देश/क्षेत्र/एक्सचेंज उपसर्ग को प्राथमिकता देता है और उसके न मिलने पर चार अंकों के देश/क्षेत्र उपसर्ग का उपयोग कर सकता है; यह न मानें कि यह फ़ील्ड हमेशा पूरे एक्सचेंज की पहचान करता है।
city, state, countryमेल खाने वाले आवंटन उपसर्ग का मेटाडेटा। ये फ़ील्ड ग्राहक के वर्तमान भौतिक स्थान या नंबर पोर्ट होने के बाद उसके वर्तमान दूरसंचार सेवा प्रदाता की पहचान नहीं करते।

त्रुटियाँ

केवल HTTP 200 पर निर्भर रहने के बजाय JSON में status.code पढ़ें। संदेश Not part of NANPA के साथ API कोड 404 का अर्थ है कि सेवा द्वारा उपयोग की जाने वाली तालिका में कोई उपसर्ग मेल नहीं खाया; यह किसी वैश्विक नंबरिंग प्राधिकरण का निर्णायक निर्धारण नहीं है। अमान्य अंक संख्या या नंबर न दिए जाने की स्थिति में API कोड 500 का उपयोग होता है।

लागत और अगले चरण

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