Utviklere

GET/v3/countries

List land i katalogen (eldre format)

Eldre endepunkt som returnerer synlige land knyttet til katalogen over spesialnumre som brukes av GET /v3/other/{isocode}, i en meldingskropp med formatet {code, data}. Det kontrollerer ikke lagerbeholdningen. Bruk GET /v3/getcountries for å finne land med numre på lager.

På denne siden
  1. Forespørsel
  2. Svar
  3. Feil
  4. Tilgjengelighet og sideeffekter

Dette eldre endepunktet returnerer en meldingskropp med formatet {"code", "data"} i stedet for standardinnpakningen status/response. Det lister synlige land knyttet til katalogen over spesialnumre og kontrollerer ikke lagerbeholdningen.

For nye integrasjoner:

  • Bruk GET /v3/getcountries for å finne land med numre på lager.
  • Bruk GET /v3/other/{isocode} for å se hvilke typer spesialnumre som faktisk tilbys i et land. Selv for et land som er oppført her, kan det endepunktet returnere en tom katalog.

Forespørsel

Påkrevd: HTTP Basic eller Bearer-token (se Autentisering og API-svar). Ved mislykket autentisering returneres HTTP 401 i standardinnpakningen før oppslaget utføres.

GET uten parametere og uten meldingskropp.

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

Svar

Meldingskropp i eldre format uten standardinnpakningen: {code: 200, data: [...]}. Det finnes ikke noe status-objekt eller felt med navnet msg eller results. data lister land uten garantert rekkefølge. Felt: countrycode (landskode for telefoni uten '+'), name, description (samme verdi som name), isocode, latitude og longitude. Feltene is_mobile, sms_coverage og next_function finnes ikke. Et land oppføres når det er synlig og knyttet til katalogen over spesialnumre. Lagerbeholdningen kontrolleres ikke, så et oppført land kan for øyeblikket være uten tilgjengelige numre. Hvis ingen land oppfyller vilkårene, er data null.

Illustrasjon av svarstrukturen; dette er ikke faktiske kontodata hentet i sanntid eller et gjeldende pristilbud.

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

Feil

  • 401: Autentisering mangler eller mislyktes. Sendes med HTTP status 401 i standardinnpakningen status/response, ikke i meldingskroppen i eldre format.

Tilgjengelighet og sideeffekter

  • Kun oppslag. Det reserverer, bestiller eller endrer ingenting.