कॉल करने वाले का नाम खोजें

कॉल करने वाले का नाम खोजें

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

लौटाया गया नाम पहचान, स्वामित्व या कॉल करने की अनुमति का सत्यापित प्रमाण नहीं है। नाम अनुपलब्ध, पुराने या संक्षिप्त हो सकते हैं; उनकी जगह किसी भौगोलिक स्थान का नाम या विकल्प के रूप में टेलीफ़ोन नंबर भी हो सकता है।

अनुरोध

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

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

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

प्रतिक्रिया

ये मान केवल उदाहरण हैं; दी गई लागत मूल्य का कोटेशन नहीं है।

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

शुल्क और हिसाब का मिलान

नाम वाले परिणामों के लिए खाते में निर्धारित CNAM दर से शुल्क लिया जाता है। खोज दोहराने या कैश से परिणाम पाने पर भी फिर से शुल्क लग सकता है; एक ही अनुरोध दोहराने पर उसका प्रभाव दोबारा होने से रोकने वाली कोई कुंजी उपलब्ध नहीं कराई जाती। स्वचालित खोज सक्षम करने से पहले खाते की मौजूदा दर जाँच लें।

कैश में नाम खाली होने पर प्रतिक्रिया की एक ज्ञात सीमा है: अनुरोध संसाधित करने वाला घटक खाली नाम, शून्य से अलग लागत और गणना में घटी हुई शेष राशि के साथ API कोड 200 लौटा सकता है, जबकि प्रक्रिया की वह शाखा खाते से राशि नहीं काटती। केवल उस प्रतिक्रिया को शुल्क लगने का प्रमाण न मानें। खाते के बिलिंग रिकॉर्ड और नई शेष राशि की जाँच के परिणाम से हिसाब का मिलान करें, और अस्पष्ट परिणाम मिलने पर सहायता टीम से संपर्क करें।

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

त्रुटियाँ और दोबारा प्रयास

HTTP स्थिति और JSON के status.code/status.msg, दोनों की जाँच करें। API कोड 403 का अर्थ अपर्याप्त प्रीपेड राशि, खरीदारी पर रोक, खाते की अनुमति संबंधी समस्या या कॉल करने वाले का नाम न मिलना हो सकता है। नाम न मिलने वाली प्रक्रिया कोड को स्ट्रिंग के रूप में लौटा सकती है। हर 403 को गलत प्रमाणीकरण विवरण का संकेत मानने के बजाय संदेश देखें। कॉन्फ़िगरेशन में टकराव होने पर API कोड 500 लौट सकता है।

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

नंबर से संबंधित अन्य कार्रवाइयाँ

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