Ontwikkelaars

GET/v3/get_document_countries

Registratielanden opvragen

Vind de ISO-landcodes en landnamen in de huidige catalogus voor nummerregistratie.

Op deze pagina
  1. Kies het registratieland
  2. Als een land ontbreekt
  3. Verzoek
  4. Antwoord
  5. Fouten
  6. Beschikbaarheid en neveneffecten

Kies het registratieland

Kopieer een ISO-landcode uit dit antwoord voordat u nummertypen of registratievereisten opvraagt. Gebruik het land waar de nummerdienst wordt geleverd, en niet automatisch het land van de nationaliteit of het adres van de klant.

Als een land ontbreekt

Als een land ontbreekt, bewijst dat niet dat er geen documenten vereist zijn of dat MultiTEL daar geen nummer kan leveren. Houd de keuze voor registratie gescheiden van het zoeken naar nummers en neem contact op met de ondersteuning als het gewenste land niet beschikbaar is.

Verzoek

Gebruik de inloggegevens van uw ingeschakelde API-account via HTTPS. Basisauthenticatie en ingeschakelde bearer-tokens voor het API-account worden ondersteund; accountbeperkingen zijn van toepassing.

GET met elke gedocumenteerde parameter in het URL-pad.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document_countries"

Antwoord

Controleer zowel status.code in de JSON-inhoud als de HTTP-status. response is een array met de tekenreeksen iso en name in hoofdletters, gesorteerd op naam. Deze registratiecatalogus verschilt van het zoeken naar nummers in de voorraad en van de algemene landenlijst die voor adressen wordt gebruikt. Dit garandeert niet dat elk land of elke beschikbare pagina met resultaten van de achterliggende dienst is teruggegeven.

Voorbeeld van de antwoordstructuur; dit zijn geen actuele accountgegevens en dit is geen actuele prijsopgave.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "iso": "US",
      "name": "United States"
    }
  ]
}

Fouten

  • 500: Unable to load available registration countries: het opvragen van registratielanden heeft geen gegevens opgeleverd. Probeer het later opnieuw; beschouw dit niet als een succesvol opgehaalde lege catalogus.

Beschikbaarheid en neveneffecten

  • Het opvragen van deze catalogus of vereisten maakt geen identiteit aan, uploadt geen bewijsstuk, registreert geen nummer en plaatst geen bestelling.
  • Een succesvol antwoord met de catalogus betekent niet dat uw documenten zijn goedgekeurd of dat is bevestigd dat een gekozen nummer kan worden geactiveerd.