פונקציה זו תאפשר לכם לרכוש מספר טלפון.
אם אתם מעדיפים לשמור על דברים פשוטים, מדובר רק בהגדרת URI ברירת מחדל של ringto (https://www.multitel.net/auth/setting , בלשונית "הגדרות URI") ולאחר מכן בקריאה ל-URL שלהלן:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
קריאה מוצלחת תחזיר את ההודעה הבאה:
{"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 | תמלול דואר קולי (Voicemail 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/ בלשונית חשבונות משנה |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... וכו'
שימו לב שהפרמטרים המשמשים עבור GET זהים בדיוק לפרמטרים המשמשים עבור POST ויש להשתמש בהם בדיוק בסדר שבו הם מופיעים ב
הטבלה שלעיל.
אנו ממליצים בחום להשתמש ב-POST במקום ב-GET, מכיוון שהוא ממזער את הסיכון להחלפת פרמטרים בטעות.