यह फ़ंक्शन आपको फ़ोन नंबर खरीदने की अनुमति देगा।
यदि आप चीज़ों को सरल रखना चाहते हैं, तो केवल एक डिफ़ॉल्ट ringto URI परिभाषित करना होगा (https://www.multitel.net/auth/setting , "URI सेटिंग्स" टैब में) और फिर नीचे दिए गए URL को कॉल करना होगा:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
सफल API कॉल यह संदेश लौटाएगी:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890असफल कॉल निम्नलिखित में से कोई एक संदेश लौटाएगी:
{"DATA":[{"RETURN":99}]} <== not enough balance to purchase number{"DATA":[{"RETURN":100}]} <== not authenticated (Check username/password){"DATA":[{"RETURN":-165}]} <== number has already been sold (check your account, possibly you hit the refresh button twice and you already purchased the number?){"DATA":[{"RETURN":-220}]} <== number is reserved (might happen when number was just released, please try again in a few minutes){"DATA":[{"RETURN":-275}]} <== this number does not exist in our inventory anymore{"DATA":[{"RETURN":-1210}]} <== number not cleared{"DATA":[{"RETURN":-1265}]} <== documentation required - usually proof of address / ID card copy (please contact us for more info.यदि आपको और पैरामीटर निर्दिष्ट करने की आवश्यकता है, तो आगे पढ़ें:
POST URL: https://api.multitel.net/json/buynumbers/
POST पैरामीटर:
| UserName | आपका लॉगिन उपयोगकर्ता नाम या आपका API उपयोगकर्ता नाम |
| Password | आपका लॉगिन पासवर्ड या आपका API पासवर्ड |
| Number | वह फ़ोन नंबर जिसे आप खरीदना चाहते हैं |
| Description | संक्षिप्त विवरण (यदि नहीं दिया गया हो, तो डिफ़ॉल्ट रूप से नंबर वाले Number फ़ील्ड का मान इस्तेमाल होता है) |
| Type | वेब इंटरफ़ेस के "फ़ॉरवर्ड करने का गंतव्य" के समकक्ष। संभावित मान हैं: 1 (SIP के लिए) या 2 (Dial के लिए) |
| RingType | क्रम से कॉल के लिए 1, यादृच्छिक कॉल के लिए 2, एक साथ कॉल के लिए 3 |
| Ringstyle | 1 घंटी के लिए, 2 संगीत के लिए (शुरुआती मीडिया) |
| URI | पहला SIP URI जिस पर रिंग हो (या डायल करने के लिए फ़ोन नंबर -- कृपया 00/011/+ उपसर्ग के बिना) |
| URI2 | घंटी बजाने के लिए दूसरा SIP URI |
| URI3 | रिंग करने के लिए तीसरा SIP URI |
| SMSRingType | ईमेल के लिए 1, URL पर POST अनुरोध के लिए 2 |
| SMSURI | ईमेल पता या POST अनुरोध का URL |
| FaxDetect | सक्षम करने के लिए 1, अक्षम करने के लिए 0। निर्दिष्ट न करने पर डिफ़ॉल्ट मान 0 होता है |
| FaxEmail | फ़ैक्स फ़ॉरवर्ड करने का ईमेल पता |
| FaxRing | हमें फ़ैक्स टोन के लिए कितने सेकंड सुनना चाहिए? डिफ़ॉल्ट 5 है |
| Vm | वॉइसमेल सक्षम है? संभावित मान 1 या 0 |
| Vmring | वॉइसमेल (VM) शुरू होने से पहले कितने सेकंड |
| Vms2t | वॉइसमेल की आवाज़ को पाठ में बदलना (Speech 2 Text) -- सक्षम के लिए 1, अक्षम के लिए 0 |
| Vmemail | ई-मेल पता जहां वॉइसमेल अग्रेषित करने हैं |
| Cnam | CNAM लुकअप सक्षम करें (संभावित मान 0 या 1 - डिफ़ॉल्ट 0) |
| Record | फ़ोन वार्तालाप रिकॉर्ड करें (0 या 1, डिफ़ॉल्ट 0 है) |
| Screening | कॉलर स्क्रीन करें (जुड़ने से पहले उन्हें अपनी पहचान बताने हेतु कहें - संभावित मान 0 या 1, डिफ़ॉल्ट 0 |
| Channels | हमें कितने चैनलों की आवश्यकता है? डिफ़ॉल्ट 2 है, जब तक कि नंबर पर केवल 1 चैनल उपलब्ध न हो। कृपया ध्यान दें कि केवल SMS वाले नंबरों (जिन नंबरों में VoIP क्षमता नहीं है) के लिए इस सेटिंग का कोई प्रभाव नहीं पड़ता, इसलिए यदि आपको इसकी आवश्यकता नहीं है तो इसे सेट न करें। |
| Atcd | टेलीमार्केटिंग कॉल की स्वचालित पहचान -- ऐसी सुविधा जो स्वचालित/रोबो कॉल को सुनती है और ऐसी कॉल पाए जाने पर कॉल काट देती है। संभावित मान 1 या 0, डिफ़ॉल्ट 0 |
| SID | उपखाता ID -- अपने उपखाते https://www.multitel.net/auth/setting/ पर उपखाते टैब में निर्धारित करें |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... आदि
कृपया ध्यान दें कि GET के लिए उपयोग किए गए पैरामीटर बिल्कुल वही हैं जो POST के लिए उपयोग किए जाते हैं और उन्हें ठीक उसी क्रम में उपयोग किया जाना चाहिए जिस क्रम में वे सूचीबद्ध हैं
ऊपर दी गई तालिका।
हम दृढ़ता से अनुशंसा करते हैं कि आप GET के बजाय POST का उपयोग करें, क्योंकि इससे पैरामीटर आपस में बदल जाने का जोखिम कम हो जाता है।