הצגת רשומות המספרים שנרכשו, שהבעלים השמור שלהן תואם לחשבון המיוצג בפרטי ההזדהות שלכם ל-API. עצם קיומה של רשומה אינו מעיד על הצלחה בבדיקת שיחה בפועל.
בקשה
השתמשו בפרטי הזדהות ל-API בצד השרת, באמצעות HTTPS. הדוגמאות קוראות את פרטי ההזדהות ממשתני סביבה; הן אינן מכילות פרטי הזדהות תקפים לשימוש. בדקו את status.code בגוף ה-JSON, וכן את קוד מצב ה-HTTP. רכיבי הטיפול הוותיקים האלה אינם מגדירים באופן עקבי קוד מצב שגיאה של HTTP כאשר מתרחשת שגיאה ביישום.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/inventory"כדי לסנן לפי מספר טלפון שמור יחיד, השתמשו בצורת הנתיב האופציונלית:
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/inventory/12025550100"השתמשו במספר הטלפון הבינלאומי השמור כספרות, כולל קידומת המדינה. אין להעביר במקומו שלוחה במרכזייה, UUID של מספר, מזהה אזור או מזהה קידומת. המספר שסופק בוחר רשומה קיימת; הוא אינו מבצע רכישה של מספר או מגדיר אותו.
תגובה
השדה response הוא תמיד מערך במקרה של הצלחה, גם בצורת הנתיב למספר יחיד. status.results הוא אורך המערך.
זהו מבנה תגובה להמחשה בלבד, ולא נתוני חשבון או הצעת מחיר עדכנית.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"number": "12025550100",
"uuid": "NUMBER_UUID",
"description": "Main reception",
"isocode": "US",
"config": {
"uri": "sip:reception@example.com",
"uri2": "",
"uri3": "",
"forward_destination": "",
"sms_uri": "",
"sms_forward_destination": ""
},
"features": {
"voice": "1",
"sms": "1",
"mms": "0"
},
"status": {
"capacity": {
"assigned_channels": "2",
"used_channels": "0",
"overflow": "0",
"overage_charge": "0.01"
},
"origination": {
"origination_trunk_id": "ORIGINATION_ID",
"origination_trunk_name": "ORIGINATION_NAME",
"origination_country_iso": "US",
"origination_continent_iso": "NA",
"origination_continent_name": "North America"
},
"service_active": "1",
"force_codec": "",
"force_dtmf": ""
},
"billing": {
"cnam": "0",
"overflow": "0",
"autorenew": "1",
"persistent": "0",
"date_created": "2026-01-01 00:00:00"
},
"price": {
"setup_price": "0.00",
"monthly_price": "1.00",
"per_minute": "0.01",
"free_minutes": "0",
"remaining_minutes": "0"
}
}
]
}| שדה | משמעות |
|---|---|
number, uuid, description, isocode | מספר הטלפון השמור, מזהה מספר שאין להסיק משמעות ממבנהו, תיאור וקוד מדינה. |
config | השדות השמורים של יעדי שיחות קוליות, העברה חיצונית, יעד SMS והעברת SMS. נקודת הקצה הזו אינה עורכת אותם. |
features | דגלי יכולות שמורים לשיחות קוליות, ל-SMS ול-MMS. אין הבטחה שהדגלים השמורים מהמערכת הוותיקה הם ערכים בוליאניים ב-JSON. |
status.capacity | ערכי הערוצים שהוקצו והערוצים שבשימוש, הגדרת גלישה וחיוב חריגה שמור. אלה נתוני מטא שמורים, ולא הצעת קיבולת עדכנית או בדיקת שיחה בפועל. |
status.origination | נתוני מטא שמורים של מקור השיחות. התייחסו למזהים כערכים שאין להסיק משמעות ממבנם; אין לגזור לוגיקה של היישום משמות פנימיים. |
status.service_active, force_codec, force_dtmf | שדות שמורים של הפעלה ושל הגדרות מדיה. דגל לבדו אינו מוכיח ששיחות נכנסות מגיעות בהצלחה. |
billing | ערכים שמורים של CNAM, גלישה, חידוש, התמדה ויצירה. קריאתם אינה משנה את הגדרות החידוש או הגדרות חיוב אחרות. |
price | מחירי הקמה, מחירים חודשיים ומחירים לדקה, וכן מכסות דקות, כפי שנשמרו. רכיב הטיפול אינו מספק שדה מטבע או הצעת מחיר עדכנית. אין להסיק את המטבע מהערכים שבדוגמה או להשתמש בהם כהצעת מחיר עדכנית לרכישה. |
סינון וחלוקה לעמודים
רכיב הטיפול הזה אינו כולל חלוקה לעמודים, מגבלת גודל עמוד או סדר מיון מפורש. הוא מחזיר את כל הרשומות שלא בוטלו ונבחרו בשאילתה שלו. הוא אינו מממש סינון למספרים שהשירות שלהם פעיל בלבד או תצוגה נפרדת של מספרים שהועברו לארכיון. אין להניח שסדר הרשומות המוחזרות קבוע.
אין מספרים תואמים
אם אין בחשבון רשומות תואמות שלא בוטלו, גוף ה-JSON מכיל status.code 404 והודעה המכילה no numbers found. לא מוחזר מערך ריק בתגובת הצלחה. ההודעה כוללת סיומת של הפניה למקור, שיישומי לקוח אינם אמורים לפענח כמזהה קבוע.
השלבים הבאים
השתמשו ב-numberinfo כאשר דרושים לכם שדות הרישום וההפניה למספר הנוספים מהמערכת הוותיקה עבור מספר אחד. בדקו את יעדי השיחות הקוליות וההודעות לפני שינוי ניתוב כלשהו באמצעות פעולת הגדרה נפרדת.