Rasti prieinamus mobiliojo ryšio numerius

Patvirtinkite, kad mobiliojo ryšio atsargos įjungtos

Naudokite šią paiešką tik po to, kai jūsų kliento paskyroje įjungtas mobiliojo numerio atsargų funkcionalumas. Gaukite galiojantį atskirą mobiliojo ryšio prefiksą per paskyros aptikimo darbo eigą. Palaikomas kelias užklauso belaidžių atsargų tam prefiksui. Tai nepriklauso nuo atitinkamo laidinio ryšio maršruto metaduomenų įrašo. Susisiekite su palaikymo tarnyba, jei nesate tikri, ar jūsų paskyra ar prefiksas yra įjungti.

Dabartinis senasis maršrutas ne visada patikimai atmeta netinkamas užklausas. Paskyra, kurioje mobiliojo ryšio atsargos neįjungtos, gali gauti įprastų atsargų, nors atsakyme vis dar nurodoma info.is_mobile: 1. Nemokamo skambučio prefiksas su tokiu žymėjimu taip pat gali pasiekti nemokamų atsargų šaką. Nenaudokite šio žymėjimo vieno mobiliojo ryšio paslaugai identifikuoti ir nesiųskite įprastinių ar nemokamo skambučio prefiksų į šį galinį tašką. Naudokite paskyros patvirtintą mobiliojo ryšio katalogą ir įjungtą darbo eigą.

Laikykite kiekvieną numerį su jo pačio kainos pasirinkimu

Kiekvienam kandidatui laikykite number, info.uuid ir to paties įrašo price sąrašą kartu. Atsakyme taip pat yra prefikso / regiono / šalies metaduomenys, sutarties sąlygos ir registravimo apribojimai. Kandidatai surūšiuoti didėjančiai pagal pirmosios kainos parinkties mėnesio kainą; vienodoms kainoms garantuotos stabilios tvarkos nėra. Nepakeiskite grąžinto numerio ID regiono ar prefikso ID ir nesujunkite jo su kito kandidato kainos ID.

Išsamus atsakymas gali apimti papildomų metaduomenų ir kainos laukų. Grąžinti features, kanalų reikšmės ir restrictions apibūdina kandidatą; tai nėra garantija, kad skambučiai, SMS, MMS ar faksas jau naudotini. Paskyros teisės, registracija ir pasirinktas paslaugos planas vis dar taikomi. Nelaikykite pavyzdyje esančių vietos žymų galiojančiais ID ar kainomis.

Naudokite mažą teigiamą kiekį

Pradėkite nuo kiekio 1. Įprasta teikėjo užklausa neteigiamą kiekį normalizuoja į 1 ir apriboja aukštesniosios pusės reikšmę iki 300, tačiau vėlesnis rezultatų apdorojimas vis dar naudoja originalią įvestį. Dėl to nulinis kiekis gali užklausti aukštesniosios pusės atsargų ir negrąžinti jokių kandidatų. Kitos senosios šakos ne visada užtikrina pageidaujamą rezultatų skaičių. Nepasikliaukite vienu universaliu maksimumu ir nesiųskite neigiamų, trupmeninių ar ne skaitmeninių reikšmių. Šiam maršrutui nepateikiamas joks palaikomas viešasis paieškos filtras ar kainos ID užklausos kūno parametras.

Atskirkite trūkstamas atsargas nuo paieškos trikties

404 atsakymas gali reikšti neprieinamas atsargas, išjungtą paslaugą, nepavykusią tiekėjo paiešką ar netinkamus katalogo įrašus. Laikykite laiko limitą ar teikėjo triktį nežinomu prieinamumu, o ne patvirtintomis nulinėmis atsargomis. Atnaujinkite pasirinkimą ir atitinkamai bandykite iš naujo su didėjančiu atidėjimu. Venkite pakartotinai apklausti kiekvienos telefonų stoties. Atskiras mobiliųjų atsargų skaičiavimo galutinis taškas yra momentinė užuomina ir nebūtinai atitinka šios paskyros kandidatų sąrašo ilgį.

Patikrinkite iš naujo prieš pirkdami

Paieška nerezervuoja atsargų. Peržiūrotoji šaka bando išbraukti jau įsigytus numerius, tačiau nepavykusi vietinio rezervavimo paieška gali palikti tokį kandidatą rezultate. Prieinamumą, nuosavybę, patvirtintą kainodarą ir registraciją turi patikrinti pirkimo darbo eiga. Naudokite naują pasirinkimą su apsaugota pirkimo užklausa ir suderinkite paskyros atsargas po kiekvieno neaiškaus pirkimo rezultato prieš bandydami iš naujo. Niekada nepirkite vien todėl, kad kandidatas buvo grąžintas.

Užklausa

Naudokite įjungtą API paskyrą per HTTPS iš leidžiamo šaltinio IP adreso. Mobiliojo ryšio atsargos taip pat turi būti įjungtos kliento paskyroje; vien API autentifikacija to neįjungia.

GET su galiojančiu atskiro prefikso identifikatoriumi ir teigiamu sveiku skaičiumi kaip kiekiu URL maršrute. Jei kiekis praleistas, numatytoji reikšmė yra 1. Naudokite pavyzdį su 1; šis maršrutas neužtikrina nuoseklaus universalaus rezultatų limito tikrinimo ir taikymo.

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

Maršruto parametrai
Pavadinimas	Tipas	Privalomas	Aprašymas
`prefix_id`	string	Taip	Nepermatomas matomas iš aptikimo gauto tinkamo atskiro mobiliojo prefikso ID. Naudokite jūsų paskyros palaikomą mobilųjį NPA/NXX telefonų stoties prefiksą; nepakeiskite jo regiono ID, grupuoto rodymo ID, pačiu rinkimo prefiksu ar nemokamo skambučio prefiksu.
`quantity`	integer	Ne	Pageidaujamas kandidatų skaičius. Numatytoji reikšmė 1. Pateikite kuklų teigiamą sveikąjį skaičių. Įprasta aukštesniosios pusės užklausa apriboja kiekį iki 300, bet tai nėra universaliai patikrinta įvestis ar atsakymo dydžio garantija.

Atsakymas

Tikrinkite JSON kūne status.code ir status.msg taip pat kaip ir HTTP būseną. Sėkmės atveju response yra numerių kandidatų sąrašas, status.msg yra Results:, po kurio eina grąžintų numerių skaičius, o status.results yra serijizuoto sąrašo ilgis. Kandidatų kainos yra specifinės paskyrai. Iliustruojantysis sutrumpintas pavyzdys vietoj realių atsargų ar tarifo pasiūlymo naudoja vietos žymas. Numeriuose yra šalies kodas be pliuso ženklo; identifikatoriai yra nepermatomos eilutės.

Iliustruojantysis atsakymo pavidalas; tai ne tiesioginiai paskyros duomenys ir ne dabartinis pasiūlymas.

{
  "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"
      ]
    }
  ]
}

Klaidos

404: Netinkamas prefikso ID, šalis ar regionas: atnaujinkite atskiro mobiliojo prefikso pasirinkimą.
404: Numerių nerasta: gali reikšti nenaudotinas atsargas, išjungtą paslaugą, nepavykusią teikėjo paiešką, nepalaikomą pasirinkimą ar paskyros apribojimus. Tai nėra autoritatyvaus nulinio atsargų skaičiaus įrodymas.

Prieinamumas ir šalutiniai poveikiai

Paieška nenuomoja ir nerezervuoja numerio, o peržiūrėtas kelias nenurašo pirkimo sumos. Ji susisiekia su atsargų teikėju ir gali užtrukti.
Sėkmingos paieškos įrašo su paskyra susijusius numerių ir kainų podėlio įrašus bei užklausų žurnalus. Pakartota paieška nėra rezervavimas, kainos užrakinimas ar pirkimas.
Grąžintas kainas, sąlygas, apribojimus ir galimybes reikia peržiūrėti pagal pasirinktą paskyrą ir numerį. Funkcijos žymėjimas nepatvirtina aktyvinimo, pranešimų siuntimo patvirtinimo ar išbandyto paslaugos funkcionalumo.