BuyNumbers REST फ़ंक्शन

यह फ़ंक्शन आपको फ़ोन नंबर खरीदने की अनुमति देगा।


यदि आप चीज़ों को सरल रखना चाहते हैं, तो केवल एक डिफ़ॉल्ट 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 का उपयोग करें, क्योंकि इससे पैरामीटर आपस में बदल जाने का जोखिम कम हो जाता है।

दस्तावेज़ खोजें