רשימת המספרים בפרויקט ניוד

גישה לחשבון ולפרויקט

השתמשו בחשבון API מופעל דרך HTTPS מכתובת IP מורשית. הפרויקט חייב להשתייך לאותו חשבון ואסור שיהיה מחוק. השתמשו במזהה הייחודי של הפרויקט מתהליך הזמנת הניוד, ולא במזהה המספרי שלו במסד הנתונים או במספר טלפון. בצעו קידוד URL למזהה הפרויקט בעת בניית בקשה.

בקשה

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"

תגובה

דוגמה לתגובה עם נתונים בדויים.

{
  "status": {
    "code": 200,
    "msg": "Project Numbers",
    "results": 1
  },
  "response": [
    {
      "id": 21,
      "number": "12025550123",
      "status": 0,
      "status_str": "Pending",
      "isocode": "US",
      "updated": "2026-10-23 12:00:00",
      "foc": "",
      "comment": "Example customer-visible note",
      "date_created": "2026-10-23 12:00:00",
      "date_completed": ""
    }
  ]
}

response היא רשימה. פרויקט קיים ללא מספרים מחזיר רשימה ריקה עם קוד API של 200 ועם ערך status.results השווה ל-0. לעומת זאת, פרויקטים שאינם קיימים מחזירים קוד API של 404.

שדות המספר

מבנה התגובה הזה משמיט את השדה המיועד לצוות בלבד, internal_comment. אין פירוש הדבר שהחיפוש הנפרד והוותיק של מספר יחיד משתמש באותו מבנה תגובה.

סדר וניטור

השאילתה ממיינת לפי זמן היצירה בסדר עולה. לשורות עם זמני יצירה זהים אין סדר נוסף מובטח. אין עימוד, סמן התקדמות מצטבר או מסנן תאריכים. קראו את הרשימה המלאה לצורך התאמת נתוני הפרויקט, ואל תתייחסו למספר השורות הנוכחי כאל קטלוג קבוע.

פירוש סטטוס הניוד

שמרו את הסטטוס המספרי וטפלו גם בערכים לא מוכרים. כאשר התווית אינה מוכרת, מוצג הערך השמור במקום תווית חדשה מובטחת. סטטוס השלמה שמור או תאריך מתוזמן אינם מהווים כשלעצמם בדיקה של ניתוב שיחות נכנסות או של כל השירותים במספר.

שגיאות ומגבלות

בדקו הן את תגובת HTTP והן את status.code/status.msg. פרויקט חסר, מחוק או שאינו בבעלות החשבון מחזיר קוד API של 404 עם הודעה שהפרויקט לא נמצא. גם הגבלות אימות וכתובת IP של המקור חלות. הדוגמאות אינן מבצעות בקשה חיה, ותגובה מוצלחת אינה הוכחה שספק תקשורת קיבל או השלים העברה.

השפעות

המטפל שנבדק רק קורא את הפרויקט ואת שורות המספרים השמורות שלו. התגובה היא תמונת מצב, ולא אישור מספק התקשורת או בדיקת שירות חיה. היא אינה מתחילה ניוד, משנה ניתוב או מחייבת את החשבון.