A katalógus országainak listázása (régi formátum)

Ez a régi végpont {"code", "data"} törzset ad vissza a szabványos status/response burkoló helyett. A speciális telefonszámok katalógusához kapcsolt, látható országokat listázza, és nem ellenőrzi a készletet.

Új integrációk esetén:

• Használja a GET /v3/getcountries végpontot a készleten lévő telefonszámokkal rendelkező országok kereséséhez.
• Használja a GET /v3/other/{isocode} végpontot annak megtekintéséhez, hogy egy országban ténylegesen milyen speciális telefonszámtípusokat kínálnak. Az itt felsorolt országok esetében az a végpont ettől még üres katalógust adhat vissza.

Kérés

Kötelező: HTTP Basic hitelesítés vagy Bearer token (lásd: Hitelesítés és API-válaszok). Sikertelen hitelesítés esetén a rendszer a lekérdezés végrehajtása előtt HTTP 401 választ küld a szabványos burkolóban.

GET paraméterek és törzs nélkül.

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

Válasz

Régi formátumú törzs a szabványos burkoló nélkül: {code: 200, data: [...]}. Nincs status objektum, sem msg vagy results mező. A data az országokat nem garantált sorrendben listázza. Mezők: countrycode (országhívószám '+' nélkül), name, description (értéke megegyezik a name értékével), isocode, latitude és longitude. Nincsenek is_mobile, sms_coverage vagy next_function mezők. Egy ország akkor kerül a listára, ha látható, és kapcsolódik a speciális telefonszámok katalógusához. A rendszer nem ellenőrzi a készletet, így előfordulhat, hogy egy felsorolt országban jelenleg nincs elérhető telefonszám. Ha egyetlen ország sem felel meg a feltételeknek, a data értéke null.

A válasz szerkezetét szemléltető példa; nem élő fiókadat és nem aktuális árajánlat.

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

Hibák

• 401: Hiányzó vagy sikertelen hitelesítés. HTTP status 401 kóddal, a szabványos status/response burkolóban érkezik, nem a régi formátumú törzsben.

Elérhetőség és mellékhatások

• Kizárólag lekérdezés. Nem foglal le, nem rendel meg és nem módosít semmit.