מציאת מספרי מובייל זמינים

ודאו שמלאי המובייל מופעל

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

נתיב ה-legacy הנוכחי אינו דוחה באופן אמין כל בקשה שאינה זכאית. חשבון ללא מלאי מובייל מופעל יכול לקבל מלאי רגיל בעוד שהתגובה עדיין מציינת info.is_mobile: 1. קידומת חינם יכולה גם להגיע לענף מלאי החינם עם אותה תווית. אל תשתמשו בתווית זו לבדה כדי לזהות שירות מובייל, ואל תשלחו קידומות רגילות או קידומות חינם לנקודת קצה זו. השתמשו בקטלוג המובייל המאושר של החשבון ובתהליך העבודה המופעל.

שמרו כל מספר עם בחירת המחיר שלו

עבור כל מועמד, שמרו את number, info.uuid ואת price (רשימת המחירים של אותה רשומה) יחד. התגובה כוללת גם מטא-נתונים של קידומת/אזור/מדינה, תנאי חוזה והגבלות רישום. המועמדים ממוינים לפי המחיר החודשי של אפשרות המחיר הראשונה שלהם, בסדר עולה; אין סדר יציב מובטח למחירים שווים. אל תחליפו את מזהה המספר שהוחזר במזהה אזור או קידומת, ואל תצמדו אותו למזהה מחיר של מועמד אחר.

התגובה המלאה יכולה לכלול שדות מטא-נתונים ומחיר נוספים. הערכים המוחזרים features, ערכי ערוצים ו restrictions מתארים את המועמד; הם אינם מבטיחים ששיחות, SMS, MMS או פקס כבר ניתנים לשימוש. הרשאות החשבון, הרישום ותוכנית השירות שנבחרה עדיין חלים. אל תתייחסו לממלאי המקום בדוגמה כאל מזהים או מחירים תקפים.

השתמשו בכמות חיובית קטנה

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

הבחינו בין חוסר במלאי לבין כשל בחיפוש

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

בדקו שוב לפני הרכישה

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

בקשה

השתמשו בחשבון API מופעל דרך HTTPS מכתובת IP מקור מותרת. מלאי המובייל חייב להיות מופעל גם עבור חשבון הלקוח; אימות API לבדו אינו מפעיל אותו.

GET עם מזהה הקידומת הנפרדת העדכנית וכמות חיובית שלמה בנתיב ה-URL. הכמות היא 1 כברירת מחדל אם הושמטה. השתמשו בדוגמה עם 1; נתיב זה אינו מאמת או אוכף באופן עקבי מגבלת תוצאות אוניברסלית.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"

תגובה

בדקו את status.code ואת status.msg בגוף ה-JSON וכן את סטטוס ה-HTTP. בהצלחה, response היא רשימת מועמדי מספרים, status.msg הוא Results: ואחריו מספר הפריטים שהוחזרו, ו-status.results הוא אורך הרשימה לאחר סריאליזציה. מחירי המועמדים ספציפיים לחשבון. הדוגמה המקוצרת להמחשה משתמשת בממלאי מקום במקום מלאי אמיתי או הצעת תעריף. מספרים כוללים את קוד המדינה ללא סימן פלוס; מזהים הם מחרוזות אטומות.

צורת תגובה להמחשה; לא נתוני חשבון חיים ולא הצעת מחיר עדכנית.

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

שגיאות

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

זמינות ותופעות לוואי

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