רשימת המדינות בקטלוג (פורמט ישן)

נקודת קצה ותיקה זו מחזירה גוף במבנה {"code", "data"} במקום המעטפת התקנית מסוג status/response. היא מציגה מדינות גלויות המקושרות לקטלוג המספרים המיוחדים ואינה בודקת מלאי.

לשילובים חדשים:

• השתמשו ב־GET /v3/getcountries כדי למצוא מדינות עם מספרים במלאי.
• השתמשו ב־GET /v3/other/{isocode} כדי לראות אילו סוגי מספרים מיוחדים מוצעים בפועל במדינה. גם מדינה שמופיעה כאן עשויה להחזיר שם קטלוג ריק.

בקשה

נדרש: אימות HTTP Basic או אסימון Bearer (ראו אימות ותגובות API). אם האימות נכשל, מוחזרת תגובת HTTP 401 במעטפת התקנית לפני ביצוע החיפוש.

GET ללא פרמטרים וללא גוף בקשה.

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'

תגובה

גוף בפורמט הישן ללא המעטפת התקנית: {code: 200, data: [...]}. אין אובייקט status, ואין שדות msg או results. data מכיל רשימת מדינות ללא סדר מובטח. השדות: countrycode (קידומת חיוג ללא '+'), name, description (אותו ערך כמו name), isocode, latitude ו־longitude. אין שדות is_mobile, sms_coverage או next_function. מדינה מופיעה ברשימה כאשר היא גלויה ומקושרת לקטלוג המספרים המיוחדים. המלאי אינו נבדק, ולכן ייתכן שלמדינה המופיעה ברשימה אין כרגע מספרים זמינים. אם אין מדינה שעומדת בתנאים, הערך של data הוא null.

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

{
  "code": 200,
  "data": [
    {
      "countrycode": "33",
      "name": "France",
      "description": "France",
      "isocode": "FR",
      "latitude": "46.0000",
      "longitude": "2.0000"
    }
  ]
}

שגיאות

• 401: האימות חסר או נכשל. התגובה נשלחת עם HTTP status 401 במעטפת התקנית status/response, ולא בגוף בפורמט הישן.

זמינות והשפעות נלוות

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