Vis lande med numre på lager

Start søgningen efter lokale telefonnumre her. Listen indeholder kun lande, der i øjeblikket har numre på lager. Den reserverer ikke noget.

Send isocode til getareas, til getstates (kun US og CA) eller til other.
next_function peger altid på v3/getareas/{isocode}. For USA og Canada kan du kalde getstates først for at afgrænse efter delstat eller provins.
is_mobile og sms_coverage er flag på landeniveau, ikke garantier for hvert enkelt nummer. For USA er is_mobile lig med 0, medmindre din konto er aktiveret til amerikanske mobilnumre.
Lande, hvor numre udelukkende er tilgængelige ved bestilling, vises ikke. Du kan stadig kalde getareas eller other direkte for et land, der ikke vises på listen.
Sortér selv listen, hvis du har brug for en bestemt rækkefølge.

Hvis intet land opfylder betingelserne, er response lig med null, og status.code er 200.

Anmodning

Påkrævet: HTTP Basic-godkendelse eller et Bearer-token (se Godkendelse og API-svar). Mislykket godkendelse besvares med HTTP 401, før opslaget udføres.

GET uden anmodningsindhold. Den eneste parameter er den valgfrie pid, som sendes i forespørgselsstrengen.

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

Forespørgselsparametre
Navn	Type	Påkrævet	Beskrivelse
`pid`	string	Nej	Avanceret og valgfri. Afgrænser listen til lande, der er markeret for én lagerkilde. Brug kun en værdi fra MultiTEL i numerisk form eller som en hexadecimal værdi på 32 tegn, og udelad den ved normal brug. pid afgrænser ikke den lagerkontrol, der er beskrevet under svaret. Ukendte værdier, nul og værdier, som dette endepunkt ikke accepterer, ignoreres uden fejl; listen omfatter derefter alle understøttede kilder.

Svar

Standardstruktur for svar. Ved succes er status.code 200, status.msg er 'Results: N', status.results er N, og response er en liste over lande uden garanteret rækkefølge. Felter: countrycode (landekaldskode uden '+'); name (landenavn); description (samme værdi som name); isocode (ISO 3166-1 alpha-2-kode); is_mobile (0 eller 1, et katalogflag på landeniveau, altid 0 for US, medmindre din konto er aktiveret til mobilnumre i US); sms_coverage (0 eller 1, et katalogflag på landeniveau); latitude og longitude (landets koordinater); next_function ('v3/getareas/{isocode}'). Et land vises kun, hvis det er synligt, og mindst ét af dets præfikser i øjeblikket har numre på lager hos en af lagerkilderne. Lande, hvor numre udelukkende er tilgængelige ved bestilling (intet lager), vises ikke. Denne lagerkontrol er bredere end de filtre, som getareas anvender, så et land på listen kan lejlighedsvis returnere 'No areas found' der. Hvis intet land opfylder betingelserne, er status.code 200, status.msg er 'Results: 0', feltet status.results er ikke med, og response er null.

Illustration af svarstrukturen; hverken aktuelle kontodata eller et gældende pristilbud.

{
  "status": {
    "code": 200,
    "msg": "Results: 2",
    "results": 2
  },
  "response": [
    {
      "countrycode": "1",
      "name": "United States",
      "description": "United States",
      "isocode": "US",
      "is_mobile": 0,
      "sms_coverage": 1,
      "latitude": "38.0000",
      "longitude": "-97.0000",
      "next_function": "v3/getareas/US"
    },
    {
      "countrycode": "44",
      "name": "United Kingdom",
      "description": "United Kingdom",
      "isocode": "GB",
      "is_mobile": 1,
      "sms_coverage": 0,
      "latitude": "54.0000",
      "longitude": "-2.0000",
      "next_function": "v3/getareas/GB"
    }
  ]
}

Fejl

401: Godkendelse mangler eller mislykkedes. Sendes med HTTP-status 401 (se Godkendelse og API-svar).

Tilgængelighed og sideeffekter

Kun opslag. Det reserverer, bestiller eller ændrer ikke noget.
Resultaterne afspejler lageret på tidspunktet for anmodningen og kan ændre sig mellem kald.