פונקציית BuyNumbers REST

פונקציה זו תאפשר לכם לרכוש מספר טלפון.


אם אתם מעדיפים לשמור על דברים פשוטים, מדובר רק בהגדרת 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, מכיוון שהוא ממזער את הסיכון להחלפת פרמטרים בטעות.

חפש תיעוד