בדיקת מלאי נייד עבור מרכזיה

בחרו קידומת נתמכת

השתמשו בקידומת נייד אישית נוכחית מתוצאות הגילוי. נקודת קצה זו מיועדת למרכזיות NANPA: NPA מזהה את קוד האזור, ו-NXX מזהה את המרכזיה. קידומת של קוד אזור בלבד רחבה מדי. אל תשלחו מזהי תצוגה מקובצים ואל תסיקו תמיכה במדינה אחרת מפני שהקידומת שלה מכילה מספיק ספרות.

השתמשו בספירה כרמז

קראו את response.count, עם response.npa ואת response.nxx המזהים את המרכזיה. זהו תצלום מצב של שירות הכיסוי, לא מלאי המוחזק עבור החשבון שלכם. אשרו מספרים בפועל, הצעות מחיר חלות וכל דרישות רישום לפני ביצוע הזמנה. ספירה מוצלחת לעולם אינה מאשרת רכישה.

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

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

בקשה

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

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

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

תגובה

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

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

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

שגיאות

• 404: ספק מושבת: כיסוי מלאי נייד אינו זמין בשירות.
• 404: מזהה קידומת שגוי: השיגו מזהה קידומת אישית נוכחי מהגילוי.
• 404: קידומת שגויה: הקידומת המאוחסנת אינה מכילה מספיק ספרות לחיפוש NPA/NXX.
• 500: בדיקת כיסוי המלאי נכשלה: החיפוש ב-upstream לא החזיר תוצאת כיסוי מוצלחת. נסו שוב מאוחר יותר עם השהיה מדורגת; כישלון אינו ספירת מלאי של אפס.

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

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