Landen in de catalogus opvragen (verouderd formaat)

Dit verouderde eindpunt retourneert een berichtinhoud in het formaat {"code", "data"} in plaats van de standaard status/response-envelop. Het geeft een lijst van zichtbare landen die gekoppeld zijn aan de catalogus met speciale nummers en controleert de voorraad niet.

Voor nieuwe integraties:

• Gebruik GET /v3/getcountries om landen te vinden waar nummers op voorraad zijn.
• Gebruik GET /v3/other/{isocode} om te zien welke typen speciale nummers daadwerkelijk in een land worden aangeboden. Voor een land in deze lijst kan dat eindpunt alsnog een lege catalogus retourneren.

Verzoek

Vereist: HTTP Basic-authenticatie of een Bearer-token (zie Authenticatie en API-antwoorden). Bij mislukte authenticatie wordt vóór het opzoeken een antwoord met HTTP 401 in de standaard envelop geretourneerd.

GET zonder parameters en zonder berichtinhoud.

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

Antwoord

Berichtinhoud in het verouderde formaat zonder de standaard envelop: {code: 200, data: [...]}. Er is geen status-object en er zijn geen velden msg of results. data bevat een lijst met landen zonder gegarandeerde volgorde. Velden: countrycode (landnummer zonder '+'), name, description (dezelfde waarde als name), isocode, latitude en longitude. De velden is_mobile, sms_coverage en next_function ontbreken. Een land wordt opgenomen als het zichtbaar is en gekoppeld is aan de catalogus met speciale nummers. De voorraad wordt niet gecontroleerd, dus voor een land in de lijst zijn er momenteel mogelijk geen nummers beschikbaar. Als geen enkel land aan de voorwaarden voldoet, is data gelijk aan null.

Voorbeeld van de antwoordstructuur; geen actuele accountgegevens of geldige prijsopgave.

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

Fouten

• 401: Authenticatie ontbreekt of is mislukt. Wordt verzonden met HTTP status 401 in de standaard status/response-envelop, niet in de berichtinhoud van het verouderde formaat.

Beschikbaarheid en neveneffecten

• Alleen opzoeken. Er wordt niets gereserveerd, besteld of gewijzigd.