ستتيح لك هذه الوظيفة شراء رقم هاتف.
إذا كنت تفضل إبقاء الأمور بسيطة، فالأمر يتعلق فقط بتحديد عنوان URI افتراضي للرنين (ringto) (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 للبريد الإلكتروني، 2 لطلب POST إلى عنوان URL |
| SMSURI | إما عنوان البريد الإلكتروني أو عنوان URL لطلب POST |
| 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 ما لم يكن للرقم قناة واحدة فقط متاحة. يرجى ملاحظة أنه بالنسبة للأرقام الخاصة بـ SMS فقط (الأرقام التي لا تدعم VoIP)، لا يكون لهذا الإعداد أي تأثير، لذا لا تضبطه إن لم تكن بحاجة إليه. |
| Atcd | الكشف التلقائي عن مكالمات التسويق الهاتفي -- ميزة تستمع إلى المكالمات الآلية/الروبوتية وتنهي المكالمة إذا اكتُشفت مكالمة من هذا النوع. القيم الممكنة 1 أو 0، والقيمة الافتراضية 0 |
| SID | معرّف الحساب الفرعي (ID) -- عرّف حساباتك الفرعية في https://www.multitel.net/auth/setting/ في علامة التبويب الحسابات الفرعية |
عنوان URL لطلب GET:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... إلخ
يرجى ملاحظة أن المعلمات المستخدمة في GET هي نفسها تمامًا المعلمات المستخدمة في POST ويجب استخدامها بالترتيب نفسه تمامًا كما هي مذكورة في
الجدول أعلاه.
نوصي بشدة باستخدام POST بدلًا من GET لأنه يقلل من خطر تبديل ترتيب المعاملات.