Pronađite dostupne mobilne brojeve

Potvrdite da je mobilni inventar omogućen

Koristite ovo pretraživanje tek nakon što je inventar mobilnih brojeva omogućen za vaš korisnički račun. Nabavite trenutačni pojedinačni mobilni prefiks kroz radni tijek otkrivanja računa. Podržani put zahtijeva bežični inventar za taj prefiks. Ne ovisi o odgovarajućem zapisu metapodataka usmjeravanja fiksnih linija. Obratite se podršci ako niste sigurni je li vaš račun ili prefiks omogućen.

Trenutačna naslijeđena ruta ne odbija pouzdano svaki neispunjavajući zahtjev. Račun bez omogućenog mobilnog inventara može primiti običan inventar dok odgovor i dalje kaže info.is_mobile: 1. Besplatni prefiks također može doseći granu besplatnog inventara s tom oznakom. Ne koristite tu oznaku samu za identifikaciju mobilne usluge i ne šaljite obične ili besplatne prefikse na ovu krajnju točku. Koristite potvrđeni mobilni katalog računa i omogućeni radni tijek.

Zadržite svaki broj s vlastitim odabirom cijene

Za svakog kandidata držite number, info.uuid i price popis tog istog unosa na okupu. Odgovor također sadrži metapodatke prefiksa/područja/države, ugovorne uvjete i ograničenja registracije. Kandidati su poredani uzlazno po mjesečnoj cijeni svoje prve opcije cijene; nema zajamčenog stabilnog redoslijeda za jednake cijene. Ne zamjenjujte vraćeni ID broja ID-om područja ili prefiksa i ne uparujte ga s ID-om cijene drugog kandidata.

Potpuni odgovor može uključivati dodatne metapodatke i polja cijena. Vraćeni features, vrijednosti kanala i restrictions opisuju kandidata; nisu jamstvo da su pozivi, SMS, MMS ili faks već upotrebljivi. Dozvole računa, registracija i odabrani tarifni plan i dalje se primjenjuju. Ne smatrajte čuvare mjesta iz primjera valjanim ID-ovima ili cijenama.

Koristite malu pozitivnu količinu

Počnite s količinom 1. Normalni zahtjev pružatelja normalizira nepozitivnu količinu na 1 i ograničava uzvodnu vrijednost na 300, ali kasnija obrada rezultata i dalje koristi izvorni unos. Količina nula stoga može zatražiti uzvodni inventar i ne vratiti kandidate. Druge naslijeđene grane ne primjenjuju dosljedno zatraženi broj rezultata. Ne oslanjajte se na jedan univerzalni maksimum i ne šaljite negativne, razlomljene ili nenumeričke vrijednosti. Nijedan podržani javni filtar pretraživanja ili parametar tijela s ID-om cijene nije dokumentiran za ovu rutu.

Razlikujte nedostatak zaliha od neuspjeha pretraživanja

Odgovor 404 može predstavljati nedostupan inventar, onemogućenu uslugu, neuspjelo traženje dobavljača ili nevaljane zapise kataloga. Tretirajte istek vremena ili neuspjeh pružatelja kao nepoznatu dostupnost, a ne kao potvrđenu nultu zalihu. Osvježite odabir i ponovno pokušajte s povratnim odgađanjem kad je primjereno. Izbjegavajte ponovno ispitivanje svake centrale. Zasebna krajnja točka za broj mobilnog inventara jest nagovještaj snimke i ne mora odgovarati duljini popisa kandidata ovog računa.

Ponovno provjerite prije kupnje

Pretraživanje ne rezervira zalihe. Pregledana grana pokušava isključiti već kupljene brojeve, ali neuspjelo lokalno traženje rezervacije može ostaviti takvog kandidata u rezultatu. Dostupnost, vlasništvo, odobrene cijene i registraciju mora provjeriti radni tijek kupnje. Koristite novi odabir sa zaštićenim zahtjevom za kupnju i uskladite inventar računa nakon svakog neizvjesnog rezultata kupnje prije ponovnog pokušaja. Nikad ne kupujte samo zato što je kandidat vraćen.

Zahtjev

Koristite omogućeni API račun putem HTTPS-a s dopuštene izvorne IP adrese. Mobilni inventar također mora biti omogućen za korisnički račun; autentifikacija API-ja sama po sebi ga ne omogućuje.

GET s trenutačnim identifikatorom pojedinačnog prefiksa i pozitivnom količinom u obliku cijelog broja u URL putanji. Količina se zadano postavlja na 1 ako se izostavi. Koristite primjer s 1; ova ruta ne provjerava dosljedno niti primjenjuje univerzalno ograničenje rezultata.

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

Odgovor

Provjerite status.code i status.msg u JSON tijelu kao i HTTP status. U slučaju uspjeha, response je popis kandidata brojeva, status.msg je Results: nakon kojeg slijedi broj vraćenih stavki, a status.results je duljina serializiranog popisa. Cijene kandidata specifične su za račun. Ilustrativni skraćeni primjer koristi čuvare mjesta umjesto stvarnog inventara ili ponude tarife. Brojevi sadrže pozivni broj države bez znaka plus; identifikatori su neprozirni nizovi.

Ilustrativni oblik odgovora; nisu stvarni podaci računa ni trenutačna ponuda.

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

Pogreške

• 404: Nevaljan ID prefiksa, države ili područja: osvježite odabir pojedinačnog mobilnog prefiksa.
• 404: Nema pronađenih brojeva: može značiti da nema upotrebljive zalihe, da je usluga onemogućena, da je traženje pružatelja neuspjelo, da odabir nije podržan ili da postoje ograničenja računa. Nije dokaz autoritativnog broja nulte zalihe.

Dostupnost i nuspojave

• Pretraživanje ne iznajmljuje niti rezervira broj i pregledani put ne zadužuje iznos kupnje. Kontaktira pružatelja inventara i može potrajati.
• Uspješna pretraživanja upisuju stavke predmemorije brojeva i cijena povezane s računom te zapise upita. Ponavljanje pretraživanja nije rezervacija, zaključavanje cijene ni kupnja.
• Vraćene cijene, uvjeti, ograničenja i mogućnosti moraju se pregledati za odabrani račun i broj. Oznaka značajke ne uspostavlja aktivaciju, odobrenje razmjene poruka niti testiranu funkcionalnost usluge.