חיפוש מידע על ניתוב

חיפוש מידע על ניתוב

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

בקשה

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

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

תשובה

מוצגים רק שדות נבחרים להמחשה; זמינותם תלויה במקור ובסוג המספר.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

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

מחיר וניסיונות חוזרים

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

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

כשלים והצלחה חלקית

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

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

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