नंबरों का अवलोकन

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

डेडिकेटेड और शेयर्ड नंबर

आपको आवंटित हर नंबर का एक kind होता है, और वही तय करता है कि आप उस नंबर के साथ क्या कर सकते हैं।

dedicated नंबर केवल आपके वर्कस्पेस का होता है। आपने इसे खरीदा है, इसके लिए आपसे मासिक शुल्क लिया जाता है, और काम पूरा होने पर आप इसे रिलीज़ कर सकते हैं। नंबर ऑर्डर करने पर आपको यही मिलता है।

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

नंबर क्या ले जा सकता है

दो फ़ील्ड बताते हैं कि नंबर क्या है, और दोनों अलग-अलग सवालों का जवाब देते हैं।

number_type नंबर का भौतिक प्रकार है: mobile, local, national, toll_free या शॉर्ट कोड। यह तय करता है कि नेटवर्क पर नंबर कैसे काम करता है और, कई देशों में, उसके लिए कौन-से दस्तावेज़ चाहिए।

capabilities बताता है कि नंबर वास्तव में क्या कर सकता है: sms, mms, voice या इनका संयोजन। जिस नंबर में voice सूचीबद्ध है, वह कॉल ले जा सकता है; जिसमें नहीं है, वह नहीं ले जा सकता। किसी खास क्षमता की ज़रूरत हो तो खोज को क्षमता के अनुसार फ़िल्टर करें, और पहले से मौजूद नंबर पर कुछ बनाने से पहले यह फ़ील्ड जाँच लें।

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

आवंटित नंबर की स्थिति

status बताता है कि कोई नंबर ट्रैफ़िक ले जा सकता है या नहीं।

active का अर्थ है कि नंबर आपको आवंटित है और इस्तेमाल के लिए तैयार है।

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

released का अर्थ है कि नंबर अब आपको आवंटित नहीं है।

ऑर्डर करना एसिंक्रोनस है

नंबर ऑर्डर करने पर एक ऑर्डर बनता है, और आप उसी ऑर्डर को ट्रैक करते हैं। ज़्यादातर ऑर्डर अनुरोध के भीतर ही पूरे हो जाते हैं और तुरंत नंबर लौटा देते हैं। जिस ऑर्डर को किसी कैरियर का इंतज़ार करना पड़ता है, वह चलती स्थिति में लौटता है, और आप उसे तब तक पोल करते हैं जब तक वह completed या failed तक न पहुँच जाए।

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

अगले कदम

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