Pročitajte zahtjeve za registraciju

Odaberite državu i vrstu broja

Odaberite državu registracije, a zatim upotrijebite naziv koji vraća get_document_number_types. Pošaljite taj naziv kao number_type, a ne identifikator vrste ili opću kategoriju za pretraživanje brojeva.

Pročitajte vraćene upute

Sačuvajte identifikatore zahtjeva i odnosa za odgovarajući tijek rada s identitetom i dokumentima. Ovaj poziv vraća zahtjeve; ne provjerava valjanost vaših datoteka niti ih predaje. Slijedite vraćene upute i sve zahtjeve koji se odnose na odabrani broj.

Nemojte tumačiti pogrešku kao izuzeće

Pogreška o nevaljanoj državi ili o tome da dokumenti za registraciju u državi nisu potrebni objedinjuje dva uvjeta. Ona nije dokaz da registracija nije potrebna. Neuspjelo pretraživanje ili prazan rezultat također ne predstavljaju odobrenje korisnika ili broja. Obratite se podršci ako je rezultat nejasan.

Zahtjev

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

POST uz application/json ili application/x-www-form-urlencoded.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  --request POST \
  --header "Content-Type: application/json" \
  --data '{"country":"US","number_type":"Local"}' \
  "https://api.multitel.net/v3/get_requirements"

Parametri tijela zahtjeva
Naziv	Vrsta	Obavezno	Opis
`country`	niz znakova	Da	ISO oznaka države iz get_document_countries.
`number_type`	niz znakova	Da	Naziv vrste iz get_document_number_types, primjerice Local; pri usporedbi se ne razlikuju velika i mala slova. Navedite naziv, a ne njegov identifikator.

Odgovor

Provjerite status.code u JSON tijelu, kao i HTTP status. response je jedan resurs zahtjeva s poljima id, type i attributes, uz relationships kada se vrate. Identifikatori u resursu i podacima o odnosima neprozirni su i ne treba tumačiti njihovu strukturu. Iz neobaveznog teksta restriction_message uklonjene su HTML oznake; preostali sadržaj obrađujte kao tekst, a ne kao pouzdani HTML. Funkcija za obradu vraća prvi resurs zahtjeva, stoga nemojte zaključiti da je ovaj odgovor iscrpan popis. Dostupnost atributa i odnosa ovisi o državi i vrsti; primjer nije potpuna, nepromjenjiva shema.

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

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "id": "REQUIREMENT_ID_FROM_RESPONSE",
    "type": "RESOURCE_TYPE_FROM_RESPONSE",
    "attributes": {
      "restriction_message": "Example country-specific instructions."
    }
  }
}

Pogreške

400: Provjera valjanosti države i number_type nije uspjela: navedite obje obavezne vrijednosti. Tekst provjere valjanosti može sadržavati oblikovanje.
400: Invalid country ISO or No country registration documents required.: ova dvosmislena poruka sama po sebi ne dokazuje izuzeće od registracije.
400: Invalid number type: upotrijebite vraćeni naziv vrste. Starija poruka o pogrešci navodi Global, Local, Mobile, National, Shared Cost i Toll Free.
500: Unable to load registration requirements for the specified country and number type.: zahtjevi nisu uspješno vraćeni. Pokušajte ponovno kasnije ili se obratite podršci.

Dostupnost i popratni učinci

Ovo pretraživanje kataloga ili zahtjeva ne stvara identitet, ne prenosi dokaz, ne registrira broj niti šalje narudžbu.
Uspješan odgovor kataloga nije odobrenje vaših dokumenata ni potvrda da se odabrani broj može aktivirati.