Lookup का अवलोकन

Lookup किसी प्राप्तकर्ता को संदेश भेजने से पहले उसके बारे में आपके सवालों के जवाब देता है। इसे कोई फ़ोन नंबर दें, तो यह बताता है कि नंबर किस तरह का है: उसे सेवा देने वाला नेटवर्क, देश, क्या उसका नेटवर्क बदला गया है, और लाइन किस प्रकार की है। इसे कोई ईमेल पता दें, तो यह बताता है कि उस पते पर भेजना सार्थक है या नहीं।

दोनों में एक अनुरोध और एक जवाब होता है। न कुछ बनाना पड़ता है, न बार-बार स्थिति जाँचनी पड़ती है, और न बाद में कुछ साफ़ करना पड़ता है। डैशबोर्ड का Lookup पेज यही दोनों ऑपरेशन एक-एक करके चलाता है। कोड लिखने से पहले जवाब कैसा दिखता है, यह देखने का यह सबसे तेज़ तरीका है।

हर लुकअप का खर्च

हर लुकअप का शुल्क आपके संगठन के वॉलेट से कटता है। इस पर कुछ बनाने से पहले यह हिस्सा समझ लें।

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

ईमेल पता लुकअप में हर उस पते का एक बार शुल्क लगता है जिसका जवाब मिला। हर निर्णय का शुल्क लगता है, undeliverable का भी: आपने यही जवाब माँगा था, और यही आपको बाउंस से बचाता है।

लुकअप विफल होने पर कोई शुल्क नहीं लगता। गलत प्रारूप वाला नंबर, हमारे द्वारा अस्वीकार किया गया पता, या पहुँच से बाहर डेटा स्रोत, इनमें से किसी का कोई खर्च नहीं है।

Lookup मूल्य निर्धारण में बुनियादी लुकअप, हर गुण और ईमेल पता लुकअप की दरें दी गई हैं।

नंबर लुकअप के दो स्तर हैं

फ़ोन नंबर लुकअप का पूरा डिज़ाइन इसी विभाजन पर टिका है, इसलिए इसे स्पष्ट रूप से समझना ज़रूरी है।

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

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

केवल ok में मान होता है, और केवल ok का शुल्क लगता है

हर प्रॉपर्टी ब्लॉक में एक status होता है, और उसे पढ़ना ज़रूरी है।

ok का अर्थ है कि प्रॉपर्टी का उत्तर मिला, उसका मान प्रतिक्रिया में है, और उसका शुल्क लगा।

unavailable का अर्थ है कि कोई उत्तर नहीं आया, इसलिए प्रॉपर्टी कुछ नहीं जोड़ती। इसका शुल्क नहीं लगा।

inconclusive का अर्थ है कि उत्तर आया, पर उससे प्रॉपर्टी तय नहीं होती: या तो नंबर उसके पीछे के डेटा की कवरेज से बाहर है, या स्रोत ने ऐसा मान लौटाया जिसे यह प्रॉपर्टी रिपोर्ट नहीं करती। यह एक वास्तविक नतीजा है, गायब उत्तर नहीं, और इसका भी शुल्क नहीं लगा।

status एक खुली शब्दावली है, इसलिए इसमें और मान जोड़े जा सकते हैं। ok पर ब्रांच करें और बाकी सब को "not answered" मानें, तो शब्दावली कितनी भी बढ़े, आपका कोड सही रहेगा।

Lookup और भेजते समय सत्यापन में से चुनना

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

अगर आप केवल उन पतों पर भेजना रोकना चाहते हैं जो पहले ही बाउंस हो चुके हैं या जिन्होंने शिकायत की है, तो आपको Lookup की ज़रूरत नहीं है। सप्रेशन यह काम अपने-आप और मुफ़्त में करते हैं।

किसी भी ऑपरेशन का बैच रूप नहीं है, और lookup दर सीमा प्रति क्रेडेंशियल 10 अनुरोध प्रति मिनट से शुरू होती है, इसलिए यह पूरी सूची जाँचने के लिए नहीं बनाया गया है। अगर आपको यही चाहिए, तो सीमा बढ़ाने के लिए हमसे बात करें।

अगले कदम

• फ़ोन नंबर लुकअप करें में बेस लुकअप, हर प्रॉपर्टी और हर एक से मिलने वाली जानकारी बताई गई है।
• ईमेल पता लुकअप करें में नतीजे और हर नतीजे पर आगे क्या करना है, यह बताया गया है।
• Lookup API संदर्भ में हर फ़ील्ड का विवरण है।
• Idempotency बताता है कि किसी लुकअप के लिए दो बार भुगतान किए बिना फिर से प्रयास कैसे करें।