קריאת תוכנית מחיר שמורה של מספר

קריאת תוכנית מחיר שמורה

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

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

בקשה

השתמשו בחשבון ה-API המופעל שלכם דרך HTTPS מכתובת IP מורשית. הגדירו את PRICE_ID למזהה המדויק של אפשרות המחיר שקיבלתם. השיטה קוראת ארגומנט נתיב אחד בלבד, ללא פרמטרים של גוף, תאריך או עימוד.

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

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

תגובה

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "visible_uuid": "PRICE_FROM_SEARCH",
      "setup_price": "2.00",
      "monthly_price": "4.50",
      "per_minute": "0.0100",
      "free_minutes": "100",
      "channels": "2"
    }
  ]
}

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

שדות מחיר

טיפול בכמה שורות תואמות

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

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

תגובות ריקות ושגיאות

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

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

השפעות ומגבלות

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