Lookup का अवलोकन

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ईमेल लुकअप में एक बैच एंडपॉइंट (POST /v1/lookup/email/batch) भी है, जो एक ही अनुरोध में 1,000 तक पते जाँचता है, जबकि फ़ोन नंबर लुकअप हर अनुरोध में एक नंबर जाँचता है। दोनों lookup दर-सीमा समूह में गिने जाते हैं। मौजूदा नीति और ऊँची सीमा का अनुरोध करने का तरीका जानने के लिए दर सीमाएँ देखें।

अगले कदम

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