Popis vrsta brojeva za registraciju

Odaberite vrstu prema nazivu vraćenom u odgovoru

Upotrijebite državu iz get_document_countries. Proslijedite vraćeni naziv vrste funkciji get_requirements. ID vrste u katalogu nije ID prefiksa, ID broja ni ID kategorije dokaza.

Broj grupa ne predstavlja zalihu telefonskih brojeva

available_groups broji zapise grupa vraćene ovim upitom u katalog. Ne broji telefonske brojeve koji se mogu kupiti, ne rezervira zalihu niti jamči da je katalog obuhvatio sve stranice izvornog sustava. Zasebno pretražite odgovarajuću zalihu brojeva i pregledajte ponudu.

Zahtjev

Upotrijebite vjerodajnice svojeg omogućenog API računa putem HTTPS-a. Podržani su autentifikacija Basic i omogućeni bearer tokeni API računa; primjenjuju se ograničenja računa.

GET s bilo kojim dokumentiranim parametrom u putanji URL-a.

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

Odgovor

Provjerite status.code u tijelu JSON odgovora, kao i HTTP status. response je polje koje sadrži id, name i available_groups. Upotrijebite name kao number_type pri pozivu funkcije get_requirements; nemojte umjesto toga slati id. available_groups je broj zapisa grupa vraćenih za tu vrstu, a ne broj telefonskih brojeva na zalihi niti ukupan broj sa svih stranica rezultata. Vrste za koje nisu vraćene grupe izostavljaju se. Prednost ima redoslijed Local, Mobile, National, Toll Free, Shared Cost, Global, nakon čega slijede ostali nazivi iz kataloga.

Primjer strukture odgovora; ne predstavlja podatke računa u stvarnom vremenu ni aktualnu ponudu.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "NUMBER_TYPE_ID_FROM_RESPONSE",
      "name": "Local",
      "available_groups": 3
    }
  ]
}

Pogreške

• 400: country is required: navedite ISO oznaku države za registraciju.
• 400: Invalid country ISO or no available DID registration country found: odaberite državu iz aktualnog kataloga za registraciju; to ne potvrđuje da dokumenti nisu potrebni.

Dostupnost i popratni učinci

• Ovaj upit u katalog odnosno zahtjeve ne stvara identitet, ne prenosi dokaz, ne registrira broj niti šalje narudžbu.
• Uspješan odgovor kataloga ne predstavlja odobrenje vaših dokumenata ni potvrdu da se odabrani broj može aktivirati.