Výpis zemí v katalogu (starší formát)

Tento starší koncový bod vrací tělo ve formátu {"code", "data"} namísto standardní obálky status/response. Uvádí viditelné země propojené s katalogem speciálních čísel a nekontroluje skladovou dostupnost.

Pro nové integrace:

• Použijte GET /v3/getcountries k vyhledání zemí s čísly dostupnými skladem.
• Použijte GET /v3/other/{isocode} ke zjištění, které typy speciálních čísel jsou v dané zemi skutečně nabízeny. I pro zemi uvedenou zde může tento koncový bod vrátit prázdný katalog.

Požadavek

Vyžaduje se ověření HTTP Basic nebo token Bearer (viz Ověřování a odpovědi API). Při neúspěšném ověření se před provedením vyhledávání vrátí odpověď HTTP 401 ve standardní obálce.

GET bez parametrů a bez těla.

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

Odpověď

Tělo ve starším formátu bez standardní obálky: {code: 200, data: [...]}. Neobsahuje objekt status ani pole msg či results. data uvádí země bez zaručeného pořadí. Pole: countrycode (mezinárodní předvolba bez '+'), name, description (stejná hodnota jako name), isocode, latitude a longitude. Pole is_mobile, sms_coverage ani next_function nejsou přítomna. Země je uvedena, pokud je viditelná a propojená s katalogem speciálních čísel. Skladová dostupnost se nekontroluje, takže pro uvedenou zemi nemusí být v danou chvíli dostupná žádná čísla. Pokud podmínky nesplňuje žádná země, má data hodnotu null.

Ukázka struktury odpovědi; nejde o aktuální údaje účtu ani o aktuální cenovou nabídku.

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

Chyby

• 401: Ověření chybí nebo selhalo. Odesílá se s HTTP status 401 ve standardní obálce status/response, nikoli v těle ve starším formátu.

Dostupnost a vedlejší účinky

• Pouze vyhledávání. Nic nerezervuje, neobjednává ani nemění.