रूटिंग जानकारी खोजें

रूटिंग जानकारी खोजें

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

अनुरोध

अपने सक्षम API खाते और उसके लिए अनुमत स्रोत आईपी पते का उपयोग करें। देश कोड 1 सहित पूरा नंबर अंकों में दें। उदाहरण में परिवेश चर और एक काल्पनिक नंबर का उपयोग किया गया है। अनुरोध संसाधक विराम चिह्नों को मानकीकृत नहीं करता; भेजने से पहले इनपुट की वैधता जाँचें।

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

प्रतिक्रिया

केवल उदाहरण के लिए चुने हुए फ़ील्ड दिखाए गए हैं; उनकी उपलब्धता स्रोत और नंबर के प्रकार पर निर्भर करती है।

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

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

मूल्य और दोबारा प्रयास

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

प्रीपेड खातों के लिए कोड कम से कम 0.00025 शेष राशि की जाँच करता है। अपर्याप्त शेष राशि वाला इसका संदेश अभी $5 का उल्लेख करता है, जो उस सीमा से मेल नहीं खाता। इस विफलता को शेष राशि के कारण अनुरोध अस्वीकार होना समझें और दोबारा प्रयास करने से पहले खाते में उपलब्ध धन की पुष्टि करें।

विफलताएँ और अधूरी सफलता

HTTP स्थिति और JSON के status.code/status.msg, दोनों पढ़ें। मानक खोज का परिणाम खाली होने पर API कोड 404 लौटता है। API कोड 403 अपर्याप्त प्रीपेड शेष राशि का संकेत दे सकता है।

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

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