בדיקת כיסוי ההקצאות בצפון אמריקה

בדיקת הכיסוי בטבלת ההקצאות

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

בקשה

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

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/nanpacheck/12025550123

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

תשובה

ערכי השדות מובאים להמחשה בלבד; זו אינה תוצאה מטבלת ההקצאות החיה.

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}

שגיאות

קראו ב־JSON את השדה status.code, במקום להסתמך רק על HTTP 200. קוד API 404 עם ההודעה Not part of NANPA מציין שלא נמצאה קידומת תואמת בטבלה שבה משתמש השירות; זו אינה קביעה מוסמכת וסופית של רשות מספור כלל־עולמית. קוד API 500 משמש כאשר מספר הספרות אינו תקין או כשהמספר חסר.

עלות והצעדים הבאים

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