Udviklere

GET/v3/countries

Vis katalogets lande (ældre format)

Ældre endepunkt, der returnerer synlige lande knyttet til det katalog over særlige numre, som GET /v3/other/{isocode} bruger, med {code, data} som svarindhold. Det kontrollerer ikke lagerbeholdningen. Brug GET /v3/getcountries til at finde lande med numre på lager.

På denne side
  1. Anmodning
  2. Svar
  3. Fejl
  4. Tilgængelighed og sideeffekter

Dette ældre endepunkt returnerer {"code", "data"} som svarindhold i stedet for standardindpakningen status/response. Det viser synlige lande knyttet til kataloget over særlige numre og kontrollerer ikke lagerbeholdningen.

Til nye integrationer:

  • Brug GET /v3/getcountries til at finde lande med numre på lager.
  • Brug GET /v3/other/{isocode} til at se, hvilke typer af særlige numre der faktisk tilbydes i et land. Et land, der vises her, kan stadig give et tomt katalog der.

Anmodning

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

GET uden parametre og uden anmodningsindhold.

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

Svar

Svarindhold i ældre format uden standardindpakningen: {code: 200, data: [...]}. Der er intet status-objekt og ingen felter med navnene msg eller results. data viser lande uden nogen garanteret rækkefølge. Felter: countrycode (landekode uden '+'), name, description (samme værdi som name), isocode, latitude og longitude. Der er ingen felter med navnene is_mobile, sms_coverage eller next_function. Et land vises, når det er synligt og knyttet til kataloget over særlige numre. Lagerbeholdningen kontrolleres ikke, så et land på listen kan i øjeblikket være uden tilgængelige numre. Hvis intet land opfylder betingelserne, er data lig med null.

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

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

Fejl

  • 401: Godkendelse mangler eller mislykkedes. Sendes med HTTP status 401 i standardindpakningen status/response, ikke som svarindhold i det ældre format.

Tilgængelighed og sideeffekter

  • Kun opslag. Det reserverer, bestiller eller ændrer ikke noget.